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GETTING STARTED 
The enclosed tape contains: 


o Version 2.5 of HOT Z for the 20688 computer. 
This is the bank-switching version that runs 
in any of the three memory banks built into the 
2068. It supports all of the common printer 
interfaces and is PROMmable. It is recorded as 
a data tape and must be loaded with LOAD "" CODE 


o Version 1.8 of HOT 2-2068. This is a smaller 
HOME bank Cordinary RAM) version with a slightly 
smaller command set than v. 2.5. It supports only 
the 2040 printer and cannot be PROMmed. It provides 
access to all memory below address BCOOH. 


GQ Version 1.9 of HOT 2-2068. This is a clone of 
version 1.8 that provides access to all HOME Ran 
above ASOOH. Both v. 1.8 and 1.8 include a BASIC 


loader/saver program, so load them with LOAD "" and 
wait until the double load Finishes and HOT 2 
autostarts. 


These notes deal primarily with v. 2.5. The other versions are 
operationally the same, except for the lack of a few commands and 
the memory bank management. You will only need the smaller 
versions if you refuse to enlarge the memory of your 2068 and 
require access to addresses used by v. 2.5 (8000 - DFFFH). 


After LORD "" CODE, you can cold-start HOT 2 in HOME bank with 
RANDOMIZE USR 32777. You can then burn the code to EPROM, 
transfer it to another bank on a non-volatile RAM board, or exit 
back to BASIC and save the code to disk. (Code starts at 32768 
and is 24575 bytes long.) 


When HOT 2 is cold-started, you must make a choice cf printer 
interface. Select the 8040 if you have no Printer attached. 
Your printer selection will start HOT Z with disassembly of the 
First few addresses of the HOME ROM. Enter any hex address to 
move the disassembly there; Sooo will find the Beginning of HOT 
2. 


HOT Z commands ars issued with the various Symbol- and 
Cap-Shifted keys. These keys are generally referred to both by 
their BASIC equivalents (e.g. PEEK or ATN or OR) and by the 
actual keying sequence, where CSS means Caps & Symbol Shift and 
release, and SS means Symbol-Shift and hold during the Following 
keypress. Thus FLASH and CSS-SS-U are equivalent, as are <= and 
SS-Q. 


HOT 2 deals with blocks of memory by marking them cut with a 
Cursor and an entered address known as END. The value of END is 
displayed whenever the cursor is turned on. The cursor can be 
turned on with sither SS-E ( >= ) or SS-A ( STOP 5. The value of 
END will appear at the end of the second screen line. It can be 
changed by giving the TO (SS-F) command and then typing the 
desired address in hex. Turn off the cursor by hitting ENTER. 
CIF you get tangled up in the mnemonics line through mistyping, 
escape from that first by hitting the semicolon, then ENTER.) 


So to move v. 2.5 to either EPROM, NU-RAM, or a backup tape, 
first turn on the cursor and set END to OFFF. This marks out the 
24K block occupiad by HOT Z. To save that block tz tape, give 
the CSS-S command (RESTORE), type HOT 2 For the name, hit ENTER 
and proceed as in BASIC. Such tapes are loadable from BASIC as 
CODE tapes. = ==. 2 2 


HOT 2 on a NU- RAM Board 


To transfer HOT Z to a NU-RAM board, set the board’s bank switch 
tg either Dock or Exrom (Dock will autoaboot, Exrom won’t.) and 
the protect switch to UR Cwrite). Then, with the cursor cn, give 
the transfer command (CSS-T2. The query S/D Banks? will appear 
on the top line, requesting the source and destination banks of 
the code to be moved. The Home bank, here the source, is bank 
FF; the Dock is bank OO and Exrom is bank FE, so enter either 
FFOO or FFFE (no spaces) depending on how you have set the switch 
on your NU-RAM board. You will immediately be asked for Dest, 
which is the destination address to which the code is to be 
moved. In this case you want the code to remain at 8000, so type 
that. After you have typed the last zero, you have the choice of 
aborting the operation Cif you’ve made an entry error) by hitting 
the space bar, or of executing the operation by hitting ENTER. 
There will be a small flash an the screen and the code will be 
moved. . To look at memory in another bank, give the CSS-G command 
with the cursor cff and type in the desired bank number CFF, FE, 
or OO2.-.Ihis command switches on memory above 32X; see the notes 
on the -variable DISB for switching low memory bares. 


After you have transferred HOT Z, move the protec switch of your 
NU-RAM Board back to the PR position. IF you hav. noved HOT Z to 
the Dock, you have only to switch your 2068 cff and on again to 
autostart HOT Z with a mostly clear Home bank. To start HOT 2 in 
Exrom, go to BASIC with SS-Q and execute the following command 
line: 

OUT 255,128:0UT 644; e40; RANDOMIZE: USR 3977 


The Exrom version is most useful if you also have some means of 
using the Dock bank for other code. There is also least chance 
of conflict with any other devices attached to your 2068. 
Running in Exrom is probably the only suitable way to use HOT Z 
with the RAMEX disk system, For example. 
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HOT 2 on EPROM 


If you have an Oliger burner beard, HOT Z will burn itself to 
EPROM for you. You will have to set the END value according to 
whether you are burning 2764's or 27128’s. The 8K segments are 
8000 - SFFF, AOOO - BFFF, and COOO - DFFF; just span a pair for 
87188's. (Uith a pair of '188's, you can have 8K cf your own 
code above EOOO.) Set cursor and END For the size of chip to be 
burned, give the FLASH command cCCSS-SS-VU), select the type cf 
chip you have in your burner from the menu, enter 0000 for DEST, 
hit ENTER, turn on the burner power, strike a key, and wait for 
the beep and Power Off message. Turn the power off, strike a 
key, and remove the finished EPROM. Install the two or three 
chips in a cartridge board mapped to 8000, and HOT 2 will 
autoboot. 


HOT 2 on Disk 


With the Aerco disk system, you may want to move HOT 2 to Dock 
RAM as described for the NU board, then exit to BASIC ¢SS-@) and 
save the Dock version to disk as an .aro file. You can also use 
it on a NU-RAM board in Exrom bank, which is the necessary way 
for the Ramex system Cor use v. 1.9). I have heard from users 
who are running it from disk with the Timex Portuguese system, 
but I have no information as to whether that system allows full 
bank access. 


HOT 2 in Home RAM 


The cnly limitation you must observe when running in a single 
bank of RAM is that you do not overwrite the HOT Z code. If your 
test program gets off the leash and runs wild, it may destroy the 
resident copy cf HOT 2 and cause a crash, as will errant memory 
transfers. This mode is useful from reading code that is already 
on cartridge, but note that the only bank that the 2068 can save 
to tape is Home RAN. 


INTRODUCTION 


HOT 2 combines a line-by-line assembler, a labelling 
disassembler, a single-stepper and a simple editor. The purpcse 
of HOT 2 is to give you a reasonable degree of direct control of 
your computer, as well as to assist you in writing 
assembly-language programs to extend your control. 


HOT 2 requires some Knowledge of the hexadecimal Chex) number 
system, which uses the characters 0-9 and A-F as its 16 digits. 
These instructions were written with the assumption that you know 
the fundamentals cf 280 machine code, for which there are 
numerous books on the market. If you are learning, then use HOT 
Z as a Blackboard to work out the exercises. 


This section provides an introductory tour of HOT 2. The 
experienced and the adventurous among you will want to plunge 
right in. If so, arm yourself with the short command lists and 
and try your luck. Details cf the various commands are available 
in the later sections of these notes. Version 2.5 has somewhat 
abbreviated on-screen help, which can be reached with CSS-H from 
any of the three modes. f 


HOT Z comes up showing the First screen "page” of disassembled 
ROM. Down the left side of the screen, you will see the 
memory-address column, to which everything in HOT 2 is keyed. 
These addresses are in hexadecimal and in the format accepted as 
input By the program. In other words, all addresses are four hex 
digits and include leading zeroes but no identifying symbols 
either before or after. The format is always there for you to 
consult as you make entries to HOT 2. Addresses run From Oooo to 
FFFF. 


The second column of the disassembly display lists the contents 
Gf each memory byte, again in hexadecimal, two digits per byte, 
packed together with no spaces between. These numbers occur 
strictly in the order they cccur in memory, which is not 
necessarily an easy order for reading. This column is rau data, 
as it were, against which any “interpretation” can be checked. 
280 instructions can be from one to four bytss in length. A HOT 
2 routine gets the length of any instruction and parses the bytes 
into instruction- length clusters, but it cannot decide whether 
those bytes hold true 280 cede, as here, or simply numbers used 
as data. That decision in the end is up to the reader. On this 
First page of ROM, the First two instructions are one byte long, 
the third three, etc. 


The next column, the NAME column, will hold user-entered labels 
For the corresponding address, along with a few labels provided 
in a permanent file cn your criginal tape. After you have 
annctated a program with these labels, you can SAVE a NAME 
separately from HOT 2, to be loaded again with whatever pr 
the labels pertain tc. 
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The fourth column presents those particles of electronic acetry 
known as assembly mnemonics. Relative jumps (JR's? are listed, 
as in the sixth line, with their destination address (cr NAME) 
rather than the single displacement byte with which they are 
coded. System variables for the ROM ars listed by an abbreviated 
name, as in lines + and S. 


The First four instructions turn off the keyboard interrupt, set 
^ ta zero load DE ta count SK of memory, and jump to the 
initialization routine. The rest cf the screen is taken up by 
RST routines. RST 10 prints the character whcse code is in A, 
RST OB handles BASIC error reports, RST 18 and 20 help with 
interpreting BASIC, and RST 28 is the entry to ficating-point 
operations, which are a separate sub-language in the Z068. RST 
O8 and 88 are always Followed by one or more (for 28) bytes that 
serve as data rather than as machine code. The meaning cf such 
bytes is listed in the mnemonics column if you have the 
Floating-point interpreter switched on. 


The current HOT Z display is referred to in these notes as READ 
mode or disassembly. The commands in this mode are mainly for 
moving the display around to give access to different parts of 
memory. The page flip, for example, is the SPACE bar; hit it to 
continue the disassembly with the instruction Following the one 
at the bottom of the screen. For distant moves, you can enter a 
four-digit hex address to the ADDR cursor at the upper-left 
screen corner. For example, try OD31 to see the initialization 
routine. 


During address entry, you can backspace to correct an error By 
using the DELETE key, which will back up the cursor one space. 
DELETE doesn’t blank out the entry and that you can’t back out of 
the whole entry routine that way. To back out, use the ENTER 
key, which works as an escape Key in this situation. You must 
type in all four hex digits of an address or all four characters 
of a NAME Clabel). ENTER is not Needed after the last hex 
address digit. 


Ihe HOT 2 keyboard responds almost identically ta way it responds 
in BASIC. HOT 2 gives a different tone feedback (You can alter 
that by changing pip_.) and gives the tone For CAPS LOCK and the 
SYMBOL-SHIFT/CAPS-SHIFT (CSS) combination as well. CAPS LOCK is 
initially set.  Louer-case a through f are nct recognized as hex 
digits, so if you shift to lower case to enter a label, be sure 
to shift back before entering hex or 280 mnemonics. The 


lower-case mode is indicated by cursor flashing and bright rather 
than just flashing. All the shift-key entry combinations are the 
same as in BASIC, except that the K-cursor state is not used by 
HOT 2, so the keyword legends on the keys themselves are not 


available. 


In READ mode, you can also get to a named routine by entering the 
Four letters of an assigned NAME. Try KEYB. You will see that 
the NAMES appear in both the NAME column (referring to the 
current address) and in the mnemonics column (referring to the 
target address of CALLs or jumps). 


In general, you can use a NAME in the File as a proxy for its 
address in the READ, Assembly-Edit, or One-Step modes of 
operation. 


If you did not do so before loading, set the screen to your 
Favorite color combination using the BORDER (on CSS-SS-BORDER, 
i.e. the BRIGHT key), PAPER, and INK commands. They work 
essentially as in BASIC, except that the color comes up right 
away. 


Try keuing SS-G (THEN) From READ mode. This is the display — 
switch, and successive strokes of the the same key will take you 
back and forth between the data and the disassembly displays. 
Ihe data display is for examining those parts cf memory that are 
used as files of data rather than for 280 code. The first and 
second columns contain the single address and its content in hex, 
values that are reflected in decimal in columns four and Five. 
(Use it as a conversion table.) The far-right column gives the 
CHRS of the contents of the address and will turn up any BASIC 
programming or message Files. Enter, for example, the address 
O2G27 to see the keyboard File. Switch back to disassembly while 
you’re still looking at the keyboard file For a taste of what 
disassembled data (sometimes called nonsense) looks like. It's 
up to you to distinguish sense from nonsense when reading a 
strange program; the display switch is there to help you do it. 


Ihe NAME calumn in the data display Functions differently fram 
the column with the same heading in the disassembly. The NAMES 
In the data display are those that correspond to any tuo 
successive bytes, taken in lo-hi order, in the second column. 
The disassembly displays NAMEs assigned to the addresses in the 
first column.) Some NAMES in the data display can crop up by 
chance; for example, two NAMES immediately together mean that at 
least one is spurious. 


Use the CSS-T command in READ mode to go to the beginning cf the 
NAME file. The NAME File grows downward like a stack, which it 
is not, as you add new NAMEs to memory addresses. Turn on the 
data display to see the structure of the NAME file. Each NAME 
takes six bytes; the First two hold the address to which the NAME 
is assigned, hence the listing in the NAME column, and the next 
Four hold the NAME itself, which shows in the CHRS column. Other 
cdd CHRS symbols will appear at random for some of the address 
bytes, signifying nothing. 


The data display is also useful f 
see the real structure of BASIC c 


You can enter decimal addresses tc t cscr, 

must be prefixed by the CR (SS- commarc. pa ib. and c 
conversion with the data display. IF you enter a decimal ad 
of less than five digits, then you have to press ENTER to tea 
HOT 2 that you’ve Finished. IF you enter a decimal higher = 
64K, the program will subtract 64K and give you what’s is 


Now get into disassembly and go tc 3B8E, which is where tre ROM 
begins the BASIC function LN. Hit CSS-Q0 (PEEK) to turn on the 
Floating-point interpreter. The first instruction after the RST 
28 restacks the number on the top cf the calculator stack in Full 
Five-byte form Cin case it is a short integer); the number is 
then duplicated on the stack and tested For being pcsitive 
non-zero; if it is, a jump is made to 2837; otherwise, execution 
proceeds to end the floating-point code and Fall into the trap 
For error A. At 3B37, ue have an example of Flcating point code 
that is embedded and nct preceded by an RST 28 because cf the 
jump. To get the correct interpretation, enter 383” to the ADDR 
Cursor, then use the switch command on the CSS-I (CODE) key. 


At 3B3S you will see a rendition of a BASIC error report after 
RST OS, in this case for a zero or negative argument to the 
logarithm. Occasionally, you will encounter a CF as data rather 
than RST OB, in which case the error number may be invalid and 
left blank. 


The last display on the tour is the 280 register display or 
Single-Stepper. This mode can be entered by using the STEP 
CSS-D) command from the disassembly. 


The register display cccupies the top three quarters of the 
screen. The left column lists the varicus 280 registers; please 
refer to a good 280 reference book if you need an explanation of 
the register names. The exchange flags are listed as EXFLAGS. 


The second column lists the hex values of the registers’ 
contents. Values for the accumulator (A) are listed at the left 
of the column to remind you that A is the high half of the AF 
register pair, along with H, D and B. The third column either 
converts the second column value ta signed-decimal according to 
the two’s complement convention, or, if the second column holds 
an address that has been NAMEd, then that NAME is listed in the 
third column. The fourth column, headed by the open parentheses, 
gives the hex value of the byte contained in the address Formed 
by the register-pair values. (E.g., across from HL you will find 
the byte CHL).) The right column gives the CHRS of the byte in 
the fourth column (for the register pairs) or of the byte in A. 


The box below the one containing the exchange registers holds 
details on the one-step user’s stack and the state of the Flags 
registers. The user's stack is separate from the main machine 
stack so that the system can absorb a few stack errors without 
crashing the program. The top four pairs of Bytes on the user's 
stack are shown at the right, along with the NAMES For any 
addresses they might hold, so that you can check to see whether 
your test routines leave anything behind. The main Flags are 
listed below the exchange flags for easier visual associatian 
with the conditionals in the program steps below. Standard 
conditional mnemonics are given for the four programmers’ bits. 


The cursor at the left in line 18 Cwhich is bright) marks the 
address of the next step set up to be executed by the 
Single-stepper. You can enter any address into that cursor just 
as you would in READ mode, or you may also use a NAME. The ENTER 
key still serves as an escape during address or NAME entry, but 
it has another more important Function as well, which is to run 
the next single step. 


If it's not already there, enter OS3A to the NEXT slot, and then 
notice the contents of the A and C registers just before and 
after you press the ENTER. This is a fairly safe area and you 
can experiment with a few more steps. (The things you must be 
careful about are loading into some system variables, either 
ROM's cr HOT 2’s, and some flag sets. The SPACE key allows you 
to skip the step at NEXT. The top line of 280 instructions 
represents the previous step executed, and the three steps 
Following the one in NEXT are those that will be reached if there 
is no branching. A branched-to step appears directly in the NEXT 
slot; a skipped step disappears from the display. 


For faster debugging, you can set breakpoints CAT and OR 
commands) and use the SS-G (THEN) command to step through the 
code as far as the first breakpoint encountered. Two breakpoints 
are provided sao that your can cover both sides of a conditional 
branch. You must take care to set breakpoint addresses that the 
code will actually encounter, since stopping depends on finding a 
breakpoint exactly. The BREAK key will stop the CSS-G command if 
used quickly enough. You can display the current breakpoints 
with the SS-Y CAND) command. 


Breakpoints are only checked for in your main code line, not 
during any subroutines CCALLs or RSTs). This may nct be ideal 
For all your tests. If you want to set breakpoints within your 
subroutines, then change the RTBP (DOED) routine as follows: the 
second instruction CDOFO) should CALL STEP ¢CD7102) and the 
second last instruction (010A) should CALL STEZ (CD40DS2?. IF ycu 
make these changes, then don’t use both the window and cade with 
RST 10s that you run to breakpoint. 


Learners might consider mastering the use cf the Single-Step 
First and then using it to see how the varicus instructions and a 
feu resident routines work. A lot of bugs can S avoided oy 


testing every routine you write with this device. You can alsco 
create a special display screen that will show the display cf 
your test routine and alternate with the register display. See 


the section on the Single Step Window for details. 


Hit SS-Q (Quit) to get back to the main READ display. You will 
arrive at a screen page that starts with the address that was in 
the NEXT slot of the Single-Stepper. IF you spot an error caming 
up at the bottom of the Single-Step display, you can quit the 
display, EDIT the error on the disassembly display, and get back 
to where you were in the Single-Step by using the STEP command 
From READ mode. 


You can alse go directly to assembly mode within the Single Step 
display to make minor changes to upcoming code. The CSS-A key 
will give you a cursor at the head cf the mnemonics column and 
let you make changes without exiting Single Step. You are 
effectively in the edit mode with a return address to Single Step 
on the stack. Consequently, all of the edit commands are 
available to you, but you must make judicious use cf them. It 
would not be wise, for example, to invoke the Single Step while 
editing under the Single Step. 


A number of operations may redo the screen to the EDIT mode or 
otherwise damage the register display. However, the Single Step 
screen will reestablish itself as soon as you exit the EDIT mode 
by hitting ENTER. 


Operations that move to a different address in edit will not 
change the current address in the NEXT slot. That will be 
preserved just as if you had left the Single Step and then come 
back to it. Moving the cursor out of the disassembly area into 
the register display is usually prevented and not advised. 
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SOME ESSENTIALS 
DISASSEMBLER FEATURES 


The HOT 2 disassembler has been specially programmed for the 
Sinclair ROM to take account of the system variables, the BASIC 
error reports, and the floating- point aperaticrs, which make ug 
the Sinclair ‘calculator language’. 


Abbreviations of system variable names are included in the 
permanent NAME file that loads with the program. The HOT 2 
disassembler always uses the name for a system variable whether 
it is referred to by absolute address (e.g. SC72) or bu a 
displacement from IY CIY*3B2). However, if you want the IY form 
From the assembler, you must write it cut, since the assembler 
will always substitute an address (two bytes) For an entered 


NAME. 


When an RST OB occurs, the Following byte is not 280 code but is 
used as data to generate the BASIC error report. HOT 2 reads 
these bytes as ERROR S, stc., rather than generating 280 
mnemonics For them. If you are cunning the disassembler over a 
Block of data, you may encounter a CF Chex for RST 08) Follcwed 
By a Byte that would be out of the range cf the error reports. 
In that case, the error number is not printed. 


An RST 28 is the ZX RUM's entry into the Floating-point language, 
which can be disassembled by HOT 2. You can switch the f-p 
language interpreter on or off with the CSS-0 (PEEK) command in 
READ. The default on start up is off. If you want to know what 
is going on in the Floating-point routines, then consult appendix 
A of these notas. 


PRINTERS 


The Oligsr, Aerco, Tasman, or A&J printer interfaces are 
supported in addition to the 2040. You are asked to choose which 
interface at boot up. If you use a Centronics interface and you 
find that your printer double spaces HOT 2's output, then you can 
change the code in RAM at SDE3, which sands a carriage return and 
line feed at the end cf each line, to send just the line feed. 


If you burn your oun EPROMs or run HOT Z in RAM, then make the 
above change in the template code at B942. 


COLOR 
You may also want to change the calor byte at 800A. Set the 
calors you prefer either from BASIC or with the HOT Z commands, 


and then lock at the attribute file (SBOO-SAFF) and install the 
predominant byte you find there at 800A. 
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CONFLICTS 


HOT 2 keeps its error fielder at SC2F in the streams area cf 

the system variables. IF ma interfers with any of your 

peripherals, then change SC2F to 8824 at SOSF and B3DC. Changes 
can be made in a running version and will take eff ect cn next — 
boot up. (Color is immediate.) B 


HOT 2 takes over the printer channel pointer and does not restcre 
it. If you move back and forth between BASIC and HOT 2 and 
expect to print from both, then you will need to restore dal 
address of your printer driver at GBYF (268703). 


If you use all three banks of memory, then you must keep accaunt 
of the value in port 8255. It is possible for that port to hold 
128 even when no =XROM chunks are enabled. (Port 244 = 9.) IF 
the value of port 35 is undetermined, then you won’t know 
whether you are e ling Dock ar EXROM chunks with part 244. 


THE DISASSEMBLY BANK VARIABLE CDISB) 


In addition to the bankswitch command (CSS-G), the variable DISB 
(disassembly bank) can be manipulated directly by the user to 
control what you see with the disassembly and what memory you 
change with HZ commands. OISB is a two-byte variable that is 
actually a bamk-chunk spec; the high byte is the bank (FE = 
EXROM, FF = HOME, OO = DOCK) and the low byte is the active-low 
chunk-enablae byte (OO enables all chunks, FE enables chunk O, 7F 
enables chunk 7, etc.) The default on start up is FFOO, which is 
all chunks of the HOME bank. 


Most values can be written in directly, but there are a few 
combinations that hang the machine. All zeroes, for example, 
mean enable the dock everywhere, which locks out the stack, as 
does any combination of bank and chunk spec that turns cff 
chunk = with the stack in it. 


Valid ..^binations of bytes for DISS will depend on what you have 
connected to the 2088. IF you can hook up a chunk O in some 
bank, then you should have an interrupt fielder at CC38 as a 
minimum before you enable such a bank without a DI. You can copy 
Gut the code From 0038 to OO4B in the EXROM if you need a 
Fielder. Chunk 8 contains the system variables and the HOT 2 
RAM-res code, and you will have to come up with a smart routine 
to make use of that chunk. Finally, chunk 3, from 6000 to 7FFF, 
contains the stack, and that must be moved to an active RAM chunk 
before you can switch cut the Home RAM chunk 7. 


Awkward values for DISB can generally be avoided by replacing 


them backwards (high byte First) or by using the Transfer command 
to move two bytes into DISB together. 
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RAM USE 


HOT 2-@ROS has its variables and buffer area in RAM at SFGO-SFFF. 
This could ultimately get in the way of the Syscon parameter 
table for memory banks and intelligent devices, but there is room 
for four or five, which should do for the near Future. HOT 2 
uses a RAM-resident block of code, which is presently located 
between SDOÓ and SDFF. This could cause conflict with other 
devices or programs that use the same area. HOT Z does not use 
the SEOO-SEFF area. Your workspace in RAM runs from SO bytes 
above STKEND to FFFF and of courses any other banks not occupied 
By HOI 2. 


HOOK COMMANDS 


For use with EPROMs the PI and the TAB keys can be hooked to your 
routines in RAM to turn them into HOT 2 commands. All you do is 
write the address if your routine at the appropriata address. 
Those are as follous: 


READ: PI SF30 
TAB SFSeG 
SIERP; PI SF94 
TAB SFSS 
EDIT: PI SF SB 
TAB SFSA 


It will not be possible ts write an address to the command file, 
if the command file is in EPROM. The routine that you hook up 
must be in normally enabled RAM, which is to say RAM below 8000H. 
You can enable and call into high RAM with CALL 5007, CALL 

YOUR ROUTINE, JP SDOC. 


-13- 


WRITING AND EDITING 280 CODE 


The READ mode is a essentially passive, allowing you t2 rage 
through the memory and examine its contents. The WRITE cr 
EDIT modes are there ts let you make changes in the memcryg 
content, provided that memory is RAM. 


There are three WRITE/EDIT modes. With the disassembly 
display, you can press CSS-A (STOP) and a curser will appear 
at the top line of the edge of the right column. This is the 
Assembly mode. Once you turn on the cursor, you change the 
entire command system of HOT Z. The commands available to you 
with the curser on are listed as the EDIT-mode commands on 

the command lists. Hitting ENTER with the cursor in its 


where you can readjust the screen to another part cf memory. 


In addition ta the command set, the up and down cursar 
controls allow you ts move the cursor tz a given line or ts 
scroll the display page cne line up cr down By moving the 
curscr up from its top position or down From its lowest 
position. Up scrolling is automatic when you ENTER a line 
that is third from the screen bottom. 


You may also enter a new 280 instruction to replace the one 
listed an the cursor line. Just start typing and the existing 
line will disappear. As you type, the delets key and the left 
and right cursor controls will function as you expect them ctc. 
IF the cursor is over the top cf a character, your next 
keystroke will replace that character. IF you want ts insert 
a character, press the EDIT ksy and a space will 2e created at 
the curser position, with all characters tco the right cf the 
cursor being shifted one space right. The rightmost character 
in the line Cusually a Blank) is destroyed by this insert 
command. You cannot jump to ancther line with the up cr down 
cursor command while you are in the middie of editing a given 
line. 


When you have entered the intended 280 instruction, hit tha 
ENTER key t2 put the proper code inta memory. IF your entry 
is in the proper format, the cursor will return to the left 


ea 


edge of the column and move one line down, ready t2 edit the 


next line. IF the cursor stays put in the line you are 
working cn, then it indicates a format error in the mnemonic 
entry. 


HOT Z Follows the Format cf the mnemonics listed in the Zilog 
280 technical manual. This format is the same as that listed 
with the character set in your computer's instruction manual, 
with the Following exceptions: the RST’s are followed by a 
hex Byte (08,10,18,20,28,30,38) rather than decimal and the 
QUT (N), O and IN S, (N) use the parentheses shown here. (N is 
always a two-digit hex byte.) The open parenthesis is always 
preceded by either a space cr a comma, and spaces are always 
important. 
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when HOT Z fails to accepts your entry, it locates the line 
Curscr at the first position that doces nct match its tsmziaca 
Sor a proper instruction. Sometimes, however, as with an 
omitted space cr an unassigned label, the cur May appear 
earlier than your particular format error. (Far exampise, it 
will flag the First letter cf a label even if oniy the Fourth 
letter is "wrong”.) 


If you get stuck and can't get HOT Z ta accept what you've 
entered, you can abandon ship and restore the original 
mnemonic by hitting the semicolon (;). Your recourse then is 
to look elsewhere in the disassembly for the Format cf the 
instruction you have besen trying to enter, or ta icck up the’ 
hex code For that instruction and to enter that in the hex 
Column (Ses below.) to discover how HOT Z lists the mnemonic. 


If you try ta back out of a line with the cursor-left key, HOT 
Z will act as if you have tried to ENTER the line. IF you 
write all the way to the end of the line an ENTER will alsco be 
automatically appended. This occurs with some cf the IY-N 
instructions, which just Fit in the alloted space. 


You can use a preassigned NAME in an instruction anywhers chat 
a 16-bit (Four hex digits) number occurs. For example, 

LO HL,Crmtp) is equivalent to LO HL, (S5CB2). You must give a 
NAME to a particular address (CSS-N ar INKEYS command in 
WRITE) before you attempt to use it in an instruction. 


Upper/Lower Case 


Since HZ doses not recognize lower case for hex input nor the 
main part of a mnemonic, it can be inconvenisnt ar even puzzling 
to be in that shift state on an RGB monitor with no bright 
cursor to indicate what is happening. There are a Feu automatic 
turn-offs of the lower-case state: after entering a new NAME, 
after entering an assembly line, and on turning an Hexedit. The 
shift state does persist if you enter a lower case NAME t2 the 
top line cursor in READ mode; this causes it to Fail ta 
recognize addresses like Sc77 until you retoggie the cass .cck 


Key. 
Jump Instructions 


Relative jumps (IRS and LINE) are normally entered with the 
destination address or NAME. However, for the JRs only (nat 
DJNZ) a second form is available for short forward jumps where 
ycu haven't yet assigned a NAME but know how far Forward you . 
want to jump. JR +S will jump ahead over five bytes. The 
plus sign is required and the displacement is in decimal 

with a range from O to 127. Backward jumps are not catered 
for in this way; it is easier to look Back for the address you 


want to get to. 
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Provided you do not want one of the last four conditional 
expressions (M, P, PO, or.PE), you can use relative Jumps all 
the time, and if the destination address is toa far away HOT 2 
will convert your JRs ta JPs Cabsolute jumps) rather than 
report an error. The reverse is not true: if ycu enter a 
very short absolute jump, HOT 2 will take your word for it. 
This conversicn works well for entry cf new code, but you must 
beware when editing in the middle cf an axisting routine, 
because if a two-byte JR is edited and becomes a three-byte 
JP, then the first byte of the following instructicn will te 
overwritten. 


Pseuda-Ops 


There is no ORG command because you are doing the ORG yourself 
with HOT 2. However, direct data entry is possible in the 
assembly-edit mode through use of the OB psaeudo-cp. DB may te 
Followed By a quoted string (DB "ABCDE"J or by an even number 
of hex digits (DB OSOF OD382. Spaces are ignored in reading 
the hex digits, except for the required space after the DB. 
Each pair cf hex digits is read as one bytes, and a single 
digit laft over will be ignored. ‘You can writs a string or 
series of digits all the way to the end of the line. 


Wren you hit the end, HOT Z will add the guste if necessary 

and enter the line. Upon entry, the editor enters cna 

character (for a string in quotes) or tuo hex digits per byte 
starting with the cursor address for as many bytes as it takes, 
then resets the screen layout so the next cursor address is at 
the top of the screen. The reason for this is that the data you 
have entered would be disassembled by HOT 2, producing a 
nonsensical listing. You can lock back with the data display tc 
assure yourself that what you have entered is indesd there. 


The DB is simply a means cf entering data without leaving the 
assembly-edit mode. You should still assign NAMES tc your 
strings or variables and use them in referencing the data. 
The insert command is recommended when you enter data ints an 
existing ccde block. 


If you want to use the RELOCATE command (described belsw), 
then you should not mingle small blocks cf code and data. 
Keep them in large blocks and keep track cf what is where. 


In addition to string entry with DB, you may also enter guctad 
nor-inverse characters for direct eight-bit register lads cr 
For direct arithmetic/logic operations. LA, 2“ will 
assemble as LI 4,41 and CP "Z" as CP SA. Sixteen-bit Cdouble) 
register loads arse not treated in this way. 


Hex Edit Medes 


Hit the >= kay with the disassembly display t2 get ints the 
main hex edit mode. The “heme” column for the curser in this 
case is between the address and hexccce columns at the left of 
your screen. Cursor controls work as with the assembly 


editar. 


Io change the hex cantent of memory, you may either move the 
cursor cover with the cursor-right key or retype the line, 
using the keys from O ta F. With the disassembly display, 
each line holds the correct number of bytes for a single 280 
instruction. If you write a one-byte instruction, the cursor 
will jump to the next line immediately; for multi-byte 
instructions, the cursor waits cn the line until the required 
number of bytes have besn entered, then jumps automatically. 
The purpose of this faature is to allow you to copy hex 
listings from printouts or magazines. You can just type away 
without worrying about hitting ENTER at every line, and the 
screen will scroll along with your entries. 


With the edit mode, what you see in the hex column is what you 
get when you make an entry, byte for byte. Edit does not use 
NAMES and you have to calculate the displacements for any 
relative jumps you enter. 


All cf the EDIT-mode commands are available with the hex-ecit 
cursor on screen. There is, however, no character insert 
while you are editing a line, and the escape key in the middle 
of a line is ENTER rather than semicolon. If you need to 
change the First byte of a line after you have started editing 
it, you should escape by hitting ENTER and start over. 


You can hit the SS-G ‘THEN, display switch) key either before 
or after you have gone to the hex-edit mode in order to obtain 
the data-edit mode. This mode lets you change one byte at a 
time by writing a new value aver the top. This is the mode 
that you would use for entering hex data files, addresses and 
the like. (Use the DB command From the assembly mode for 
entering text Files.) All write commands are available from 
this mode as well, except the NAME CCSS-N) command functions 
differently than it does with the disassembly display. 

CSS-N will no longer assign a new NAME, but can be used ta 
write a preassigned NAME to the NAME column, and the accress 
to which that NAME belongs will then appear at the cursor 
address and the bute Following. The intended use is For 
creating address files (jump tables). 


Inserting and Deleting Lines (All EXIT Modes) 


What happens when you press ENTER after writing an instructicn 
is that HOT 2 reads the address cf the line you are working 
an, looks up the the numeric code of the instruction, anc 
enters that code into as many bytes as it takes. Then control 
gces back toa the disassembler, which reads Back your coge ints 
ZB0 mnemonics and revises. the screen page accordingly. An 
important consequence of this is that when you are sditirg an 
existing block of code you must be careful nct to overwrite 
more lines than you intend to (by entering a four-byte 
instruction over a two-byte instruction, sag) and ta watch cut 
For new instructions that crop up when you overurits a long 
instruction with a short cne Cone-byte over a three-byte 
instruction, for example). 


If you dan't know the bytes length of 280 instructions, the way 
around the above problem is ta use the line-insert CEDIT) and 
line-delete (DELETE) commands whenever you are editing an 
existing block of code. 


When you insert or delate a line, a block of code is moved 
either to make room or to close up the empty space. One end 
of that block of code is determined by the cursor; the other 
end must be determined by you before you start your editing 
session. Whenever the WRITE cursor is on, a variable called 
END is displayed in the upper right corner cf your screen. 
END marks the other end of the active memory block for an 
insertion or a deletion or indeed for any block cperaticn, 
such as a clear, a Pill, a SAVE, or a transfer. END is set 
with the TO key Cas in IO the END) followed by four hex digits 
or a NAME. On some types of entry errors, you may be asked 
twice For the proper value. 


You should set END whenever you begin an editing session. For 
the insert-line and delete-line commands, END must be within 
256 bytes of the cursor address, or else you will be asked tz 
enter a new value of END when you give the insert ar delsta 
command. At that point, HOT Z will accept any value you enter 
For END and perform the operation. The purpose cf this 
Behavior is ts catch these times when you have Forgotten to 
set END, and to save you From destroying valuable code. 


There ars three separate commands to set END, just to make it 
easy. The TO key will work in either EDIT or READ mcdses, or 
yOu can use the OR (SS-I) key in EDIT mode tc pass the address 
at the cursor directly to END. END is generally always on 
screen when you need to know it. 


For insertions and deletions, END can be either above z 
the cursor address. The "usual" value would te fcr END 
point ta an addzess higher than tha curser accress, in whish 
case an inserticn uculd push ali values tz higher adcresses io 
make csom for the new instruction. Far examplis, if you insert 
a two-byte instruction at 8C10 with END set ta 8CS0, then all 
instructions From 8C10 will be moved tua bytes higher until 
SC7E, which will go into B8CBO, and the criginal contents of 
8C7F and 8C80 will be destroyed. A deletion cf a tuüc-Eygts 
instruction would move all instructions ta lower addresses, 
and the contents of SC7F and 8C80 would be duplicated in 8C7D 


and SC7E. 


On the cther hand, if the address in END is lower than the 
cursar address, then an insertion will leave the Following 
addresses undisturbed but will push the contents of preceding 
addresses to lower addresses as far as END. For example, with 
END set to Seco and the cursor at 8C10, inserticn cf a 
three-byte instruction would destroy the contents cf SCOO, 
SCO and Sc by overwriting them with the contents of BCO3, 
8CC4 and 8COS, respectively. Analogously, a deletion would 
duplicate the first three (or N) Bytes in the next thres. The 
insertion itself will in this case go into the address 
Preceding the cursor address. This feature is useful when 

you are editing in a constricted memory Block with Blanks that 
may be either above or below. 


After insertions or deletions, the cursor position may have to 
be adjusted for your next entry. (Ihe preceding discussion 
uses "above” and "below” to refer to numerical values of 
addresses, not to screen position, where addresses get higher 
as you go down the screen.) 


When a NAME is assigned within a block where you are inserting 
or deleting lines, the NAME will move with the instruction to 
which it is assigned. The displacement assigned ta relative 
jumps is not adjusted, so JR TARG may cread JR 8C22 after an 
insertion that pushes TARG Fram 8C22 to 8Ce3. Be sure and 
label all JR destinations and then check that the labels are 
still correct after an editing session. IF you use Labels ail 
the time, then an error will stand out clearly. 


When you are editing the data display, all insertions anc 
deletions affect one byte at a time. 
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Using EDIT Commands 


Many of the EDIT commands affect a block cf memory anc require 
that the END variable be set First to a proper value. use ihe 
IU key to set it. Aside From its use for inserticns and 
deletions of lines, END is generally set to denota the end of 
a block of code, whereas the cursor marks the beginning. [Ff 
END is less than the cursor address, the block is generally 
taken to be null, though sometimes the cperaticon will stiil 
affect the very first byte. Most operations include the END 
address; the exceptions are SAVE and LOAD, which finish cone 
byte before. (This makes it effectively impossible to LOAD or 
SAVE address FFFFH, since the next address is COCO, which is 
less than any cursor address.) 


The block commands are LOAD, SAVE, FIND, TRANSFER, CLEAR, 
FILL, LLIST, READDRESS and RELOCATE, in addition to the line 
insert and delete described above. The simpler commands ars 
SS-A and SS-E, which toggle the cursor across the screen 
between assembly-edit and hex-edit; SS-G, which toggles thes 
display between disassembly and data and works only in 
hex-edit because you can't assemble data; CSS-N and CSS-X, 
which allow you to assign or delets a NAME at the cursor 
address; STEP, which takes you to the single stepper; and 
CSS-RUN, which transfers control to the program beginning at 
the cursor. 


The cassette commands (LOAD, SAVE, VERIFY) allaw you to move 
the contents of individual blocks of memory to and From tape 
in the CODE format. Such tapes will be loadable by the 
corresponding BASIC command if you calculate the length (END - 
cursor address) and work out the decimal values. Similarly, 
CODE-format tapes made in BASIC will load with HOT 2 when you 
have made the numeric conversions to hexadecimal. The BREAK 
key works to interrupt any of the cassette Functicns. Error 
reports will appear on screen with a BEEP, and the system will 
wait for a keystroke before accepting any Further commands. 


Cassette functions all require tape names, which are entered 
without quotes after you give the command and before you press 
ENTER. Maximum length for such tape names is the stancard 10 
characters. An incorrect loading space (END minus cursor 
address) for the tape in question will result in a taps 
loading error. IF you get such an error, you can inspect CSBF 
and following addresses with the data display: the length you 
enter is at CSBF OC, the length read From the tape at CSEF + 
1C. Then correct your setting of END. 
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To use the transfer command, set END and hit the appropriate. 
command keys. This will bring up S/D Banks? (Source 
Destination) in the top line. For normal use in Home Bank, 
Just respond Sy hitting ENTER. For interbank transfers, 
consult the First section of these notes. fer you resperd 
t2 the Banks? request, a DEST cursor will come up at the 
upper left, which asks you for the destination address zf e 
Block. HOT Z will wait for you te hit ENTER after that 
address, and if you change your mind or Find you've entered i 
incerrectly. you can Bail out By hitting the SPACE key instead 
of ENTER. After the command has executed, the display will 
move t3 the address you gave to DEST. 


The FIND command has a similar protocol to Sie of transfer, 
gut it works only in the bank that is on display via D:SB. 

In this case, set the cursor to the Bag an DAD cf a block 

cf memory for which you want to find a match. Set END ts the 
last byta of your template. Hit CSS-F (SGN). An address 
cursor labelled LOOK will come up at the upper left. Enter 
the address at which the search should begin; hit ENTER to. 
proceed ar SPACE to back out. HOT 2 will search 32K (8000HD 
bytes for a match to the memory from curser t2 END; if a match 
is Found, the display moves to it; if there is no match, the 
display remains at your template in READ mode. If you find 
gne match and want to search for another, set the cursor 
again, move the cursor daun a line or two so it doesn’t sain 

to the beginning of the Found match, and use the CSS-G ABS) 
command. If a second match is found, the display will meve ta 
it; if mot, the display stays put. (NOTE: IF you are 
searching for a block cf 8 zerces, say, and you Find a Block 
Sf 18, then to continue the search you should move the cursor 
a sc that there are 7 zerses or less bealcw it, or else „ycu 
will Find the same string all over again. 


The CLEAR command CERASE) will put zerces in all bytes from 
cursor to END. The FILL command first asks you For a 
keystroke and then fills the block with the codes for the 
character assigned to that key. CIF you clear or fill a block 
of HOT Z or the stack, you are likely to crash.) Ta Fill with 
a value not available From the keyboard, write that value to 
the HOT Z variable FILC, then use the CLEAR Cnot FILL) 
command. 
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The LLIST command in WRITE will send the content 


s cf the 
screen, starting with the cursor line, ts your 2040 zrintaer 
Printing will continue, interrupted by page flips sf the 
display, until the line just before the END address. Lf usu 


Forget to set END, you can BREAK to save paper. 


There is also a hex-arithmetic command, which, thcugh nct a 
block command, uses both the cursor address and END. The 
command is READ, and the result is the hex sum and cifference 
CEND minus cursor address) of the two values, which are 
displayed in the command (top) line. 


The Readdress (for jump tables and NAME Files) and Relocate 
(For programs) commands are described in a later sectizn cf 
these notes, due to their complexity. 


A detailed description of all the HOT Z commands is also 
included as a later section intended for occasional reference. 
Other sections will give you details on naming and NAME Files, 
the Floating-point language interpreter, and the program 
relocator. 


HOT 2's Flags 


HOT 2 uses the BASIC system variable STRLEN as 16 bit-flags, 
so you could crash the system if you try to lead that 
variable. The meaning of HOT 2’s Flags is that they are SET 
to indicate: 


Bit HZFG CIY-382 STRLEN 

2 Disassembly cf RST 08 SP display 

1 Disassembly of RST 28 RST 29 disassembly in progress 
2 An insert Unused 

3 A NAME input Unused 

4 Data display Unused 

E Hexedit not assembly Assembly in STEP 

6 F-p constants Disassembly af APPX 

7 Window in STEP Transfer of NAMES 


This use does not, to cur knowledge, affect the operation 

of a co-resident BASIC program. However, if you run a BASIC 
program and intend to return to a resident HOT Z with a warm 
start, it is best to POXE 23666 and 23587 to O. 
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Keying is described as TSS- for the peo E Shirt 
combination before ancther keystroke and SS- for SSD Shift 
pressed simultaneously with another key. Keys are referred tsz 
By any cf the three rubrics cn tne keytop. Mnemonic 
asscciations are generally with the letter cn the kay EST 


example, Assembly is Symbol-Shift/A, the STOP key. There is 
a brief help screen that you can call up From READ cr EDIT 
modes with CSS-H ¢SOQR). 

READ Moda 

Key Description 


GUIT TO BASIC 


SS-q Quit HOT Z fer BASIC. HOT 2 and the entira Dock bank 
are switched gut so that BASIC sess only Home tank 

COPY 

css- Copies the screen to the designated printer. Gives 

COPY you headings and all. Consider using the LLIST 


command from an edit mode for no headings and variable 
length.  LLIST is faster. 


SS-E Sets the cursor to the top line and switches to the 
hex-edit mode. This command alsa works from assembly- 
edit mode without resetting the cursor line. 


SSSEMBLE 

SS-A Sets S cursor to the top line and switches ts the 
assembly-edit node. The same keystrokes will get you 
From hex-sdit to assembly edit. This command werks 
only when the disassembly display is an. 

TOP NAME 

CSS-I Move the display to the ae cf the NAME Fils and 
Switch to the data display. Use this command as 
preparation fcr SAVing a derte Tile. (Torn on the 


curser, set END, and SAVE.) IF the File is still in 
EPROM and DISB is set ta its default, you will see thea 

srresponding memory space in RAM, which may Se empty 
or Fold something else. 
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RESTART 


CSS-R 


MAKE REM 


CSS-REM 


BORDER-I 
Ccss-ss-B 
-INK 
-PAPER 
STEP 


Sg* 
SIEP 


SS-GÜIO 
(THEN) 
SEI END 


88 1 


H 


NAME Fils suitch. IS you are using only one Fils, the 
NAMES are suitzhed cfF cr zn. IF you have tuc Files 
in memory, the command will switch from cne fila cc 
the cther. Before switching, you muse First urits che 
start and end addresses of the new fiis at ALNA - 
crder2. The end address is the first of tuc Sytes of 
zerces at the tap end cf the NAME Fils. Ta start a 
new File, set both addresses the same, pointing ts cua 
bytes cf zeroes, then add names tc the disasssemzi,. 
Restarts HCT Z. Resets tha stack ts clear cluttsar. 
Resets register values in the single stap ang sets the 


EPROM-residant NAME File active. 


Installs a 1 REM statement in BASIC at the value in th 
system variable prog (normally 7818H2. The REM will 
run to the value in END and will push rer BASIC 
lines to higher memory. 


NK-PAPER 


RIGHT SORDER color set. Follow with a color key. 
INK calor set. Follow with a ccicr Kay. 
PAPER color set. Follow with a color key. 


Switch to single-stepper. The address in the NEXT and 
LAST slots will be last anes used there. se this 
command ta get back after an interruption. All ais 
Single-step register values are preserved. 


The display switch From disassembly to data Sispiay sor 
back again. The same command works with the rex-edit 


- 


cursor cn but not from assembly-edit. 


Enter a value to the END variable, as in EDIT mode, 
but the value is not displayed 


-25- 


DECIMAL ADDRESS 


SS-OR 


SCROLL 


SS-<> 


SP ON 


SS-AT 


Indicates decimal adcress to 

the ADOR cursor and waits for your entry. IF the 
decimal address is less than five digits liong, “it 
ENTER after the last. 


Sets the screen tc a continucus SCROLL. BEREAK will 
stop it. A toy. 


Toggles on or off a display of the machine 
stack-pointer address in the upper right screen 
corner. The default is Off, because it isn't pretty, 
but you should turn it on when you are test running 
your own routines. There is a small amount cf shcck 
absorption in the HOT Z stack, but if you should see 
it changing, then look very carefully at what you are 
daing to the stack with the routine you are testing. 
Restarting HOT 2 will reset the stack. 


FP IN-OUT 


cCSS-0 
(PEEK) 


Switch the on-off state of the Floating-point dis- 
assembler. IF turned off, then the SS-I command 
will have no effect. If on, then every EF (RST 287 
will switch to the floating-point disassembly and 
every 38H will switch off the Floating-point 
disassembly. If you have a stray EF on screen while 
you are in an edit mode, you may get a messed up 
display when you enter cede. IF so, exit CENTER) From 
edit mode, use this command, and go back into the 
active mode without fear. Default state is OFF. 


FP INTERPRETER SWITCH 


Css 
(CODE) 


Floating-point interpreter switch. This is a flag 
switch (NOT an on-off switch) which switches 
interpretation of a byte from 280 language 88 

loating-point language. This command is necessary 
For certain embedded sections of floating-point codes 
that are not preceded by an RST 28 but are jumped ta 
from some other portion of Floating-point cade. This 
command will not Function if the PEEK switch has Seen 
set to off. IF it doesn't work, hit PEEK and try 
again. 


7 


BANK SWITCH 


ABS CCSS-G) The bank switch. ‘You can ask for FE, FF, cr 
CC. The command is set t3 switch in only the top Four 
chunks (32K). For chunks O to 3 of Dock or EXROM or for 
chunk mixtures you must still manipulate OISB; rememzer 
that Dock and EXROM don't mix because cf port F4 "zs" 
means read only (ROM? and "ru" means ceac/write. 
"ForBidden" chunks can be reached via DISB after 
appropriate precautions (putting an interrupt Fielder 


inta Dock O, moving the stack, avoiding susctasem-var.ab.as 
. references, etc.) 


PRINTER CONTROL 


FN Serds anything you have written in the printer 
buffer (at SBCC: tg the Centronics port and your- 
printer. Consult your printer manual and use it to send 
control codes to configure your margins and sage size 
for HOT Z output. Stops at the First zers byts. 


NAME FILE TRANSFER 


INKEYS Sets up an empty NAME File at the top cf RAM. 
Just give this command and add NAMEs as you checse. 
Then save your File from the address given by the CSS-T 
cammand to FFFF. 


You need this command for almost any change of NAME 
File. If you have file on tape, use this command first, 
then load the tape, then set the File start and anc at 
ALNA, then use the OVER command ta set up the nau File. 
If you want to pick up some part of the existing ROM 
file, then you will want to transfer interbank from sank 
OO to FF. A handy way to do that is tz use the 


“backwards” Format cf the transfer command. (learn it 
straight up first.) Ta do that, set ENC cs sone esgenrning 
of the part of the NAME File you want ca move Cine low 
end). Set the cursor to the high and, the fourth Latter 
cf the last NAME you want, and set DEST to FFFO cefcre 
you hit ENTER to execute. The display will show you one 
top of the new file, which you must then enter at ALNA 


before applying the CVER command. 
DISPLAY MOVE 


NOT Moves the display to the address in END. 
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PEOSRAM SANK TRANSFER 


VALS Meves HOT Z from Dock ta the EXROM bank, at the same 
e addresses, if ycu have mecified your ZCSB t2 “ave memory 
there, and runs the new versisn. 
BIN CCSS-B) Cspies HZ from Dock to BAM and starts us that 
versicn. You can start this version with RAND USR 22775 
if you lead it From tape. A warm start is stili RAND 


USR 24088. 


HOOKUPS 


CSS-M User hock-ups to the HOT Z cammand interpreter. 

CSZ" ENter the address cf a routine at SFSC, And the P! kesy 
causes a jump to that address Enter the address tz 
SFS2, and the TAB key will cause a jump to that 
address. Addresses entered must not lia in t^s range 
SOCO-BFFF. See the introduction for an explanation of 
how to call that memory rangs. 


WRITE Mode Commands 


ESCAPE 
ss-0 Escapes without change during assembly edit. 
l ; key 

a) ; 

ET: HEXEDIT 
SS-E Switch to hex-edit mode from assembly edit. Moves the 

cursor horizontally. 

ASSEMBLE 
SS-A Switch tc assembly-sdit mode. Werks snly when dis- 


assembly display and edit mode are cn. Moves the 
cursor horizontally. Doesn't work with the data 
display because assembly doesn’t apply ts data. 


DELETE Deletes the instruction at the cursor and closes us 
the code between the cursor and END. END may be 
either lower cr higher than the cursor address. 25 
END is less than the curser address, then cade is 
moved from lower addresses ta- close the space; if END 
is greater than the cursor address, then code is moved 
From higher addresses to close the space. Code at the 
END address and beyond (moving away From the cursor) 
is preserved. IF END is 256 or mors bytes away from 
the cursor, then you will be asked sach time to verify 
the END value before the command is executed. The 
purpose cf this is to prevent your messing up the 

an entire RAM by Forgetting to set END properly. 
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m 
ti 
ta 
T 


ENTER 


SIEP 
STEP 


SET END 


TO 


OR 


Sets the Insert mega for the next instruction (SDA 
to be entered. IF END is less than the cursor 
address, then instructions are pushed to l:cuer 
addresses (up the screen) as far as END; if END is 
greater than the cursor address, then instructions are 


moved ta higher addresses (down the screen’ as far as 
END. Any NAMES assigned ts shifted memory area will 


to which they were assigned. Relative jumps t2 2 
Fram the shifted area are not corrected anc may 
require a fix-up. IF END is 255 bytes cr more fr 
the curser address, you will be required to conf: 
the END value before the operation proceeds. 


10 
3 


Quit to READ mode when cursor is in "home" column. 
During hex entry, ENTER escapes and leaves t^s 
original memory contents intact. During mnemcnics 
entry, ENTER sends the line contents io the assembler 
For entry into memory. 


Single-steps the instruction at the cursor address and 
Switches to the single-step display with the result of 
of that instruction in the register values and th 
Follawing instruction in the NEXT slot. 


Brings up the END? curser that allows you t3 reset the 
END variable. Whenever a block of code needs 2 58 
marked, it is generally delineatec by the cursor 
address and the address assigned to END. Slways use 
it to block out a segment of memory for Insert ard 
Delete commands before beginning to edit. END should 
be set within 858 bytes of the cursor for editing, sut 
that restriction can be overridden in any particuiar 
case. (Ses Insert and Delete instructicns.? 


Sets END equal to the current cursor address. 
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FIND STRING 


CSS-F 


FIND the string marked Sy the cursor (first byta? anc 
END Clast byte). Sets the display to start with the 
Found string. IF no match is found, then the display 
remains at the template string. Taoa find the next 
match without going back tc the template, use 

CSS-G. Do nct use other commands between these tua. 


FIND NEXT OCCURRENCE OF STRING 


NQ 


S5-S 


FINOs the next successive match to the templatea string 
set up by CSS-F. After a match is Found, you must 
move the cursor past the beginning cf the matching 
sequence before using this command, ta avoid finding 
the same scccurrence again. 


ASSIGN NAME 


CSS-N 


NAME command. This command has tuc separatas effacts, 
depending upon whether it is used with the disassembly 
display or the data display. With the disassembly 
display, the effect is to christen that instruction 
with the NAME that you enter to the screen follouing 
the command. A NAME requires four characters with 

at least one beyond F in the alphabet. (All cf lower 
case works.) Space and semicolon should not be used. 
With the data display, the NAME you enter Following 
the command must already be assigned to some address. 
HOT Z then locks up the address for that NAME and 
pokes that address to the byte at the cursor address 
and the byte Following, then moves the curser down two 
bytes. Use this form for entering tables cf addresses 


DELETE NAME 


CSS-X 


CLEAR 


ERASE 


Deletes the NAME at the cursor address from 
the current NAME File. This command will anly affect 
the NAME that you see on screen with the disassembly 
display, so it is best not to use it with the data 
display. Do not attempt to use this command hbefcre 
you have moved the NAME File to RAM with the NSET 
command. 

MEMORY 
Clears memory from cursor address t3 END. Werks 


only on unprotected RAM. 
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| FILL MEMORY 


FN Filis memory from cursor address to END with the coda 
For a key that you specify in respense ts tne KEY? 
prompt. For unkeyable values, urits ihat values is ine 
HOT 2 variable FILC ¢SFA4%.? and then use the IRASE 
command. 

CASSETTE COMMANDS 

SAVE COLE 

css- SAVES code from cursor to END-1. Enter a tage name 

SAVE without quotes. This is a CODE-format SAVE. You 
can reload such tapes from BASIC By converting ine 
cursor address to decimal and setting tne syrte length 
to END minus cursor address. From Home bank cnriyj. 


VERIFY 


VERIFY VERIFIES a CODE format tape from cursor tao END-1. Noa 
quotes on tape name. Compares with Home bank. 


LOAD CODE 
css- LOAD from cursor to END. Loads 2068 CODE-format 
LOAD tapes. Set the cursor to the start address and END 


one byte beyond the last, such that END minus curscr 
address equals the byte length. Unlike the BASIC 
command and earlier versions of HOT Z, a tape name is 
always required by this command. No quotes are used. 
Loads to Home Bank. 


TRANSFER COMMANDOS 


CSS-T Transfers memory contant iaithner within or 
between banks cf memory) between the cursor acdress 
and END Cinclusive) to a destination (DEST? that „ou 
enter following the command. First enter scurce 
and destination Banks.  (OOFF means from Dock cto 
Home.) Hit ENTER for a default to FFFF, which 
means Home-to-Home. Then put in the Destinaticn 
address (DEST) in the bank you want the stuff to 
end up in, if that's not too many 'in's.' The ENTE! 
key after CEST executes the command; SPACE after DEST 
cancels the command; TO after DEST lets you reset END 
before the command is executed. Does not transfer 
NAMES. To do that, use the MERGE command, which is 


otherwise identical to this one. 
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CSS TRANSFER memory contents and assigned NAMES from a 
SS-T memory block (cursor acdress tc END, inclusive) ts an 
MERGE) area beginning with an address entered in response ta 
the DEST prompt. (Ses CSS-T commanc.>. This command 
depends cn the NAME File being in Home RAM; cso not 
attempt to Use it until you have done an NSET. 
CShould NSET be part of initialization?) This command 
is not so often nexessary, except For small alock 


moves. 
DIS/DAT 
ooo Display switch, data/disassembly. Works only from 
GOTO hex-edit mode. (THEN key) Answers most of your 


decimal to hex perplexities, reads BASIC and ASCII in 
rightmost column. 


RUN IT 


css- Runs coda beginning at the cursor address. Returns toa 

RUN HOT 2 with the first RET. If you do an extra POP and 
destroy the raturn address, then you are on your oun. 
CThis command expects to jump tc the bank structure 
described by DISB, Home By default, but whatever you 
set it. If you set a new bank, then then you must set 
the return which requires a JP Back to HOT 2 in Bank 
O, chunks 4 and 5.2) Recommended procedure is to test 
your routines first with the single-stepper before 
attempting the R command. 


CHECKSUM 


LEN Performs a 32-bit CHECKSUM from cursor address to END 
and switches to the STEP display, where the sum is in 
BCDE. 


HEX ARITHMETIC 


CSS-a Does hex arithmetic. Takes the cursor address (K) and 
END CE) and displays on the top line the sum (E*K2 and 
difference (E-K) in hexadecimal. Bank indifferent. 


PART SCREEN 


AT Moves cursor to far left of screen and awaits your 
entry of an address, then disassembles from that 
address to bottom of screen. Use it for a composites 
listing. Use CSS-COPY immediately after to print the 
screen display. Depends on the Bank-chunk description 
in DISB For what memory it reads. Therefore, any 
screen that can be printed will be all in cne bank. 
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CODE RELOCATION COMMANDS 


MOVE 


CSs-Y 


CSS-U 


Relocates 280 code between the cursor address and EMD. 
Readdresses all CALLs or JPs. Allcus a three-way sar- 
tition of code, variables and (constant? files. 
Requires nine addresses to be first entered ac TEML 
through TEMS. TEM variables are in the permanent MAME 
File and cohabit with inessential BASIC variables. 

Set them before you use the command. TEML through 
TEMS are the start address of the code block, the end 
address of the code block, and the destinaticn address 
of the code block. Curser and End are usually set to 
the first two of these, and the third is the DEST. 
TEM4, TEMS, and TEMS are usually the file block of 
constants associated with the program, and TEM7, TEs, 
and TEMS are generally the block of variables, cr 
reserved temporary memory space, where the cnly 
important thing is the address. HOT Z assumes that 
these three blocks can be moved independently. is 
there are blocks you don’t want to touch, then ygcu can 


use OOCOO as a default value toa any block sf thras TEM 
values. 


READDRESS a jump table (address file) between the 
cursor address and END by a 16-bit displacement value 


entered in response to the DISP prompt. Takes the 
address (lo-hi order) at each pair cf memory locations, 
adds the displacement, and re-enters the sum t2 the 


same locations. 


READDRESS that portion of a NAME File between curser 
and END by the value ycu pea t3 DISP. For special 
File manipulations anly. apes eat you snculc use the 
MERGE command to move NAMES and code arung in memory. 


COMMANDS 

COPIES screen ta 2O40 printer. [Intended mainly For 
usa with the PARTSCREEN command far printing zut 
composite disassembly From separata acdress siccis. 


Qutputs the screen and beyond ui Chest headings From 
the cursor address to END to the 2040 printer. 


zPROM BURNING 


FLASH 


Burns an EPROM on the Oliger EPROM burner. 

Format Follows the Transfer command. Coge From cursor 
to End is Burned ta the DEST address on the chi; 
(normally OOO, but you burn as little as a sin 
bytes). You are prompted for the ty : 
12882) and for burner Power On and Pouer 
Switch and hit a key when ready. 
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-34- 


Gy 


CREATING AND PRINTING ASCII FILES 


SCREENS 


LERINT 


Creates an ASCII source File that could se ecitec anc 
used with an assembler. The code in whatever Sark is 
active is disassembled, the address and nexccce columns 
are discarded, and the lines are terminated sith a 
semicolon. The ASCII codes are sent ts a fila in HOME 
bank at the address determined by the pointer 28 
CSFDB2. You must set that pointer manually by writing 
directly ts it with HOT Z. At the end cf the operation 
DESE will point to the end cf the Fils, sco gcu could 
use this command successively to creata sre Fils fram 
several separate segments cf memory. The disassembly 
begins with the cursor address and Finishes at END, 


which must be set in advance. You must have assigned 
a label to every jump or call address if jou expsct the 
file tc be palatable ta an assembler. 


Creates an ASCII File cf everything on the HOT Z screen 
From the cursor address to END. The file is created at 
the address contained in DES (SFDB) in HOME RAM. At 
the end of this operation, DES2 will point to the and cf 
ASCII file. Move that address to END with the TO 
command for printing, saving, or viewing the File. You 
should be able to get at such Files with a word 
processor in order ta add annotations for archiving. 

Be sure to set DESS low enough that your File will Fit 
belcw FFFF, as there is no check For overflow. 


Prints an ASCII file ta screen. Set the curscr to the 
First byte cf the File and set END where you want toa 
stop. Printing will pause for the Sinclair "seroll?” 
after 22 lines, and you can break with the space bar cr 
continue by hitting ENTER. This command is fcr viewing 
only; it doses not allow you ta edit the File. 


Prints an ASCII file to a line printer. Prints from the 


E] * 
cursor address to END. You can interrupt with the BREAK 
key. 
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CIRCLE Set the curser to the First address cf ore tleck ard sat 
END to the First address cf the block ta be ccmrared O 
CThis could be the same address if tha blocks ara in 
different banks.) When you give the command, ycu will 
be asked for source and destination banks: enter che 
tanks of the tuc memory Blocks. The compariscn will 
begin at cncs and the display will jump to the first 
address where the memory contents differ. 1t important 
that you only use this command with the cursor set at an 


EVEN (O, E, K, S, 8, B, C, EJ numbered address. The purccse is 
to Find small differences in two blocks zi code; tre 
command will not be useful for blocks that differ 
greatly. 


HOCKUPS 


CSS-M User hook-ups ta the HOT 2 command interpreter. 

CSS-P Enter the address of a routine at SFSB, and tke PI kay 
Causes a jump to that address. Enter the address to 
SFSA, and the TAB key will cause a jump to that 
address. Addresses entered must NOT iie in the range 
SCCO-BFFF. 


SINGLE*STEP MODE 


Key Function 

O 
QUIT 
ss-@ Quit single-step and return to READ. Return address 


is the address in the NEXT slot of the single stepper. 
Register values will- be preserved if you reenter from 
READ mode. 


ENTER Runs the instruction in the NEXT slot and reperts the 
resulting register values. 


SPACE Skip the step in the NEXT slct and Tonos ta the next 
instruction. Skipped instructions are nct listad in 
the LAST slot at the top of the disassembly segmerct. 

EDIT Backs up. Cn its First use, this command takes the 


instruction from the LAST slot at the top cf the 
disassembly listing and puts it in the NEXT slot 
Csecand line). Repeated use with no intervening 
commands will back up one more byte for each keypress. 
Intended use is just to gst the last step back. 
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PRINTOUT 


CSS- Print screen. Capies current screen t2 printer 
COPY 

RUN. IT 

CSS-RUN Run a CALL or RST 10. It is your responsibility ts 


know that the called routine will rct crash and rct 
send RST 10 any unprintabls characters. The purpose 


to 


cf this command is to shorten the time needed to step 


through complex routines. 


SET BREAKPOINTS 


OR Set 8reakpointl. Breakpoints are set just as register 
pairs are, with a NAME ar address entry inte the NEXT 
Cursor. You must set the breakpoints precisely tc the 


beginning of the instruction at which you want the 

Single-step to stop, because the stop depends on the 
address of the next step being exactly equal to the 
breakpoint. If the breakpsint points to the second 


byte of a two-or-three-byte instructicn, you routine 


will never stop until you crash or hit BREAK. 


AT Set Breakpcint2.  Breakpcints are set just as register 
pairs are, with a NAME or address entry ints the NEXT 
cursor. You must set the breakpoints precisely to the 


Beginning of the instruction at which you want the 


Single-step to stop, because the stop depends on the 


address cf the next step being exactly equal to the 
breakpoint. If the breakpoint points tg the second 


byte cf a tua-or- pees -Suce instruction, you routine 


will never stop until you crash or hit BREAK. 


AND Display the tuo breakpoints on the line balou the 
Flags display. 


- 27 ym m m 
8924288 o at 


SS-GOTO Go (run) to breakpoint. Causes the tes 
run from the address in the NEXT slct ¢ 


tuc breakpoints, which must be set in advance c£ chi 


command. Brsakpoints must be set ta an address that 


starts a command and nct to a byta embeddsc in a 
command. The GO routine checks the BREAK key after 
executing each line of cade, so you can rec 

endless loops and scmetimes from runaway cs 
you're quick) by hitting BREAK. 
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ASSEMBLY 


SS-a 


SPECIAL 


ATTR 


Set registar value. The responsa to this command will 
be REG? in the NEXT curser. You SHC respond as 
Follows for the various registers: 


For the A register 

for the BC pair 

for the DE pair 

for the Flags register 

for the HL pair 

For the user’s Stack Pointer 
For the IX pointer 

For the IY pointer 


"€ xU xt un 


Nota that all settings are 16 bits (tuc bytes? axcept 
For the one hex byte for A and the mnemonic satting 
For F. The specific Flag bits are set cr reset 

with the same mnemonics as are reported (M, P, Z, NZ, 
PO, PE, C, NC}. Use this command ta set up initial 
conditions for testing your routines. Note that you 
can set the user's SP this way. 


Sets the assembly cursor at the instruction in the 
NEXT slot so that you can EDIT it. Return to STE 
operation uith ENTER. 


DISPLAY SCREEN 


SETs a second display File CWINDOQW) starting at the 
address in NEXT and extending iBOO bytes. Any 
stepped display instructions then output ts the 
window, which comes up before the next register 
display. Be careful nct to erase valuable codas 5 
setting the window on top of it. Dismiss the scr 
with any key But V. 


y 
sen 
Toggles the Feature that causes the WINDOW to wait 
for a keystroke before going ta register display. 


Switches the window cut of the STEP loop sa that 
subsequent steps have no effect on it. 


Switches a WINDOW From QUT back IN again. WINDOW must 
be SET up first. 
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HOOKUPS 


CSS-n User hcck-ups tco the hot z command interpreter. 

CSS-P Enter the address of a routine at SFSt, and the PI kay 
Cause a jump to that address. Enter the address tc 
SFS8, and the TAB key will cause a jump tc that 


address. Addresses entered must not lie in the gange 


BOOO-BFFF. See the introduction for an explanation 
hau to call that memory range. 


SINGLE-STEP WINDOW COMMANDS 


The single-step window is a utility designed for developing 
display code. Its use is very tricky and requires that you 
first acquire some general competence in using the single 
stepper. It enables you to create, save, and see a special 
screen, but very painstakingly. 


There are Four commands, and they are all called from the 
single-step display Cunlike HOT 2-II). You must first have 1200 
(S812 decimal) bytes available for the extra screen. 


The commands are: Key | 


WINDOW SETUP ATTR 


WINDOW IN IN 
WINDOW OUT QUT 
WINDOW STOP SCREENS (toggle 


All of these are commands whose work goes on behind the 
scenes. The acknowledgement that the command has been 
executed is the same in each case, the appearance of a W near 
the left end of the LAST-NEXT line above the code section cf 
the single-step screen. 


WINDOW SETUP establishes an initial white screen and will 
destroy anything you have in the selected 1BOO bytes of 
memory. Set up the beginning byte by entering its address, sc 
that it comes up in the bright line of the single stepper. 
Then give the ATTR command. The SETUP switches the windsw IN 
and sets the STOP as well. The initial print position is the 
top left corner, but don’t forget to initialize that in your 
program for the day you expect it to run by itself. 


WINDOW OUT switches the window cut of the single step icap but 
does not destroy it. Any code steps you execute after WINDOW 
OUT will have no effect on the second screen. The point is ts 
stop it flashing on every time. 
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wINDOW IN ccuntermands OUT and brings sack a previsusily 
established window. It will nct Function if you have ncc 
previously set up a window. However, if you have previcusly 
been using a window and have eepteines the space fcr scmething 
else, and if you then use the IN command, you may get some 
strange effects. If there has never been a window, you will 
nct get the "UV" response. 


WINDOW STOP is a toggle switch. Each time ycu press it, HOT Z 
responds with a "VU" cn the LAST-NEXT line. when you 
initialize a window, the stcp is set so that the new sc 
smes up and waits for a keystroke before returning t 
register display. IF you toggie the stop, the seccrd s 
will Flash on and then get put away without waitin iS E 
keystroke. Toggle again and the stop will be rainsct a 
The point is to switch cut the stop for steps that vies t 
affect the display. 


There is ane subcommand available during the STIP. If you 
press the U key (CLS, the screen wilt be clearac anc you will 
ba reinitialized ta a blank screen and your print position 
reset ts tcp left. . ; 
The WINDOW routines respond only to the print pasitiscn in 
S POSN, nct to DF CC. The latter is always sat from the 
Former via a CALL CS14, on every step. If the windsw is IN 
when you change S POSN, then the new screen position wiil be 
remembered next time an actual print occurs. In Fact, 38 
should always use a window when you do things with S POSN, sa 
that your manipulations don't mess up the single-step screen. 


If you print with RST 10, then you shculd use the INT (RUN 
CALL? command to get all the way through the RST in one step. 
In general, the most effective use cf the window will occur 
when you set up your display routines as subroutines and run 
through them in a single step with the INT command. 


Alternatively, you can set breakpoints and use the S.n-Tz- 
Breakpoint (THEN? command to get through your screen 
manipulaticns in one quick dash. 

Ncts that you can save any screens you ars werking with by 
exiting the single step and using the HOT Z data save. You 
will mat get a SCREEN type tape From it. (You sccuid set up a 
bicck move to screen memory and call that from BASIC alsng 
with an inr-rrcgram SAVE SCREENS.) Then for re-use, First set 
up a new uindcu screen from the single stepper, ren akit arc 
lsad in the data tape to the window screen accress. 


SN NAMES AND NAMING 


HOT 2’s labelling cr naming system is intencec ts make ine 
programs ycu are reading cr wricing mere compre: nens ge en 
The F Limie i mo 


they are listed. 
Se-csiumn display. A space is 
HOT Z NAME, so use a dash or other punctuation if 

Fewer than four letters. A semicolon is also illega:i, since 
it is the escape character for the assembly editor 


The NAMES themselves and the addresses they assignrec tc are 
Contained in a special fils, referred tc as the NAME Fila. A 


NAME File is an ordered list beginning with the highest 


address <3 which a NAME is assigned (tuo bytas), then thea Four 
igttsrs cf that NAME, then the next highest address, atc. 
After the last NAME in a File, there must ba tuc zsrz zygcas. 


HCT Z takes care cf ordering the NAMES fcr you. 


HOT Z includes a NAME File that annotates the meis e HORS. ROM, 
the system variables, and HOT 2’s variables. You wiil Finda 
Few extras among the systsm variables. Ei! through TEMS ars 

icts for temporary 16-bit variables for varicus HOT 2 rsut:ines. 
CYcu may use them for any cf your oun routines for values chat 
are not required once the routine is zvar, provided your routine 
dges nct call the floating-point calculator.) 


The permanent NAME File that loads with HOT 2 can be expanded 

to hold any NAMEs you add in a session cf using HOT Z, or you 
have the option cf starting a new file from scratch. .There is 
room For 182 NAMEs in the existing File. The NAME Fils must be 
in RAM before you can add to it. If you are running in Home RAM 
or the Dock bank of an Aerce Board, you can just add cr zaleta 
NAMES. If you use a NU RAM Board, you must either unpretect it 
or proceed as if you are using an EPROM cartridge. 


If che NAME Pile is in EPROM or protected RAM, you must copen an 
empty File in RAM with the NSET command CINKEYS in READ; bsfsre 
you try to acd NAMES. The File is cpened at the top c? RAM. 
Use che RND command in READ to find the start sf the Fila. 
Af der you move it ta RAM, you can put it anywhere above ECCO ar 
belcw 8CCO. The variables ALNA is listad ts assist switching 
File locations. You might also want co copy some sf the NAMES 
from the permanent file to the RAM File. Use che ordinary 
transfer command (END? and transfer from OO ta FF. Easiest is 
to set the END address to the lowest byte you want tthe S2 

lm 


£ srs 
adcress byte cf any NAMED and the cursor ts the highest ithe 
Fourth character cf any NAME) and then usa FFFD for DEST. Tha 
Sisplay after transfer will then show the first address c? eur 
copied File. Put that at ALNA Cle-hid followed by FE Folic. 

Sy °F. Then gs tack ts READ and give she CUER command = 
on the new iist. 


If you try ta erase a NAME while the fils is in EPROM, you will 
confuse che iccsk-up and lose the use of the entire file .r-til 
ycu Teinictiaiize. 
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The Labelling system mas not seen partitione cs 22 2 

A NAME SheuS us ac nts agdrass To Tattar shat Bani Q9. ara LU. 
yoan a oset a eker iende, Suo ,., Sse le Sesser 
aizarnata filas, Hg cversomas chis procianm. 

Ada a NAME ts the fila with the SSS zommand in RITI mode 
with a disassembly inct data) cn screen. The command will 
zivs ü ) 81.55 ysu Z5 sptar 

or ratiace tha NAME Fer that address: A lagal MAME is zaja .Z 
Sf ang four single characters wish the restrictii? chet at 
leas: snra zharactar must bg cSesyord F in the alsnecet, iF j2- 
Forget that rule, HOT 2 will refuse t3 sccspt giur nau NAME 
and will ask you fcr another. 2 spaca in a NAME will ze 

SS ETA and the disassembler will list the NAME, Set gsu will 
nct be able tc use such NAMES wher working with ins essemslar.. 
wrish tarses according te spaces ard sunctuatisn. Take stare 
thas gour MAMES ara unigue, Se HOT 2 will aluays fing $51, tha 
zne at the higher address when you refer to it. [If you arter 
a NAME tz the ADDR cursor befere you assign it, than iha E 
Fite will be searched and the display sill move so a? NAS 

if it is already there; ctheruwise the display stags put.) 

The CSS-X key CWRITE) will delete a NAME at t^s curser accress 
From the screen and from the NAME File. 

Tre CSS-T command (BEAD) is there ts let you Find the start 

of ugur currant NAME file. You may want t3 check up zn it if 
gcur are working under crowded memory corditizns c= se sure 
the file doesn't overwrite scme valuable coga. This sana 
Switches the display to data and meves tc the louest address 


‘ 
cf the NAME file. Since the NAME column in the 
lists NAMES assigned to addresses formed by pair 
the hex column, the NAME appears horizontally ac: 
First address byte and then vertically opposite 
data bytes. (Ba aware that chanca scccurrences cz 
lock like addresses and cause spuricus listings in the “AME 
column of the data display.) 


You should also use the CSS-T cammand when it comes tins ta 
SAVE the NAMES you have entered in a session. However, you 
will also need to know the end address of your file ir creer 
to SAVE it. You can call up that end address Sy antaring NEMND 
ts the UE curser; the end address cf the NAME File is listed 
lc-Fi there. ‘You can either add 2 to that address tz includa 
the two zero bytes that act as a terminator, cr gcu can 


remember to zero those tuo bytes after you relcad “he tapa. 
TS Sou choose the first option, hit RNO, turn cn the 

edit cursor, set END ta NENO+2, and SAVE. Recorce ine 
addresses fcr use when ysu reload. 
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Wren you celcad a NAME File, you must install the start and 
ena addresses so that HOT Z will know where to lzck For that 
File. This is dorn + the fFour-byte block Labelled ALNA 
Calternatea NAMEs). With che data display ard the adit node, 
write the start address Cla-hi) Followed Sy the NEND 

addsess; don't forgat 22 subtract 2 if yeu have inglasad the 
2 zeroes. CIE gou daes e them, mare surs 
theg are there First.) IF you don't do these settings 
e you will hang up the program when you try t2 switch 
the new File cn. 

The NAME-File switch command is OVER in READ. It will. 
suitzh From the permanent NAME File to the ons you have 
leaded, after you have installed the File parameters at ALMA. 
TF gou use OUER without installing the new parameters, the 
effect will be to switch of? the NAMES entirely and you will 
met te able ta add neu ones. You should switch cff the 
permanent NAME Fila in this way 5sfors loading a neu fila; 
then install the start and end addresses of the neu File at 


ALNA and use OVER tz switch them in. 


Ysu cam amalgamate NAME Files only if they pertain tz sesarat 
Blacks cf memory, with the addresses in ons Block all Fisher 
than those in the other. Then just lead the tua Files end to 
end in the proper crder and save them as a singla fil 


Tc start a completely neu file, put the starting/ending 
address (the same, because it's empty) in the four bytes at 
ALNA and give the CUER command, then enter NAMEs. 


You can SAVE a NAME File as data, then LOAD it in and hcck it 
zB by writing the starting and ending address at ALNA and 

using CUER. Always remember that there must be two zer2 bytes 
accve the value you assign ts the high end c? the File. 
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USING THE RELOCATE COMMANDS (MOVE, STRS, CHRS) 
The Relocate command is rather complex in order t2 srovice you 
a degree of Flexibility in relocating your routines. ^ set of 


nine addresses must be entered before using the MOVE command, 
and a certain amount cf planning and knowledge of the sucject 


program is required to derive the correct addresses. Simple 
programs with one ar two calls or absclute jumps sr zest 
labelled, moved with the Transfer-with-NAMEs (MERGE? command 


and then Fixed iz by hand. 


A program of rusaGraBis complexity will have a block o£ S de, 
a Block of data Cwhich may include address lists cr jump 
tables), and a Block of variables. Good programming farm 
would recommend that you keep these blocks separates and 
distinct rather than, say, mingle data and variable sco2rags 

in tne crannies between your subroutines., IF you are 
programming with HOT Z, you can separate the blocks genersusiy 
as you develop your program and then use the Relccate command 
ts close the gaps when you Finish. 


HOT 2’s Relocate command will work on program blocks where 
code, data and variables are separata and distinct. [IF you 
have embedded patches cf data, the command may still work, but 
you should check the data after the relocation to maka sure 
chat it has mot been changed under the guise sf readdressing 
coda. Programs such as the 2088 ROM, where jump tables iia 
around like empty beer cans, would have to be brockan up inta 


segments and relocated piecemeal. 


The Relocate routine readdresses and moves 280 csde. However, 
the command does nct taks account cf overlapping segments 
between source and destination blocks, so you cannot directly 
relocate a program to addresses already cccupiad by that 
program. Cin such cases, you should use the transfer command 
first and then readdress in place with the relocate command. j 


Jump tables have to be revised with the CSS-Y command, which 
First asks you for a displacement and then adds that 
displacement to each address in the File, starting at the 
Cursor and ending at the END address. CIF you moved jour cade 
From 8100H ts 8400H then the displacement would be C30CH; Fram 
S4CCH to 8100H would be a displacement cf F DOCH.) Jump tables 
and data blocks should be moved with the Transfer command 
pricr to using the relocate command. 


The Relocate command (MOVE) allows ycu ts mcve the code block 
by one displacement, the data block by another, and the 
variables block by a third displacement. (Any other three-way 
separation should also work.) 


ADDRESS ENTRY FOR RELOCATING 


The variables TEIII through TEMS are used ts sat the mins 
address parameters fcr reiccaticn. The nine accresses are 
three sets cf three addresses. Each set cf thras addresses 
indicates the start and end sf an address range is Se sharged 
and the start address cf the new acdress rangs. For Sangre, 
suppose your program to se relccatec Fits the Follsuing memory 
map: 


8400-84E8 Variables 
S4FC-S4FF Data 
8500-8880 Program 


Suppose you want to put the variables and data 

at S1CCH and the program at ACO. First, transfer thea 
variazises Slack to 8100H; it will run t3 S118, sc crar 
data Dicck to 8119-8128. To move the program From 
8500 up to ACC, any addresses of jumps cr calis chat ll 
between 8500 and 8680 should 15 changec ts lis Zetuasn 202 
and ADCO. <You don't need that last number. Sc enter th 
originai range in TEM1 and rena and the First address cf tha 
new glock in TEMS, Us: 


TEM1 8500 
TEM2 8880 
TEMS ACO 


These First three TEM values always hold the parameters 
relating tz the program (z228) block. Variables and cata 
parameters can go interchangeably into TEMY¢-TEME or TEMT-TEMS. 


Acdresses of variables, which were at 9400-94E3, aust bea 
changed t2 start at 8100, and addresses oF cata, Formerly at 
84F2-94FF, must be changed ta begin at 9119, sco fill in the 
remaining TEM slots as Fallow S: 


Variables Data 

TENG e4po TEM? Suro 

TES ges TEMS gur- 

TEMS 810 Teng eris 
TEM4-5S ars cre block, TEM7-9 ths sther. Nou sat the curscr at 
2g09 (start of the coga segment) and set END ts 868C, then 
give the MOVE command. The code will be cz2pisd tz the 
new lccaticn and readdrsssed tc run with the neu variates, 
neu data block, and any relocated subroutines in t^s cocs 
sleck. The original cede will remain unchanged at its 
original location. 


M 


ty be ve 
1-0 (0 3 0 
0 0 0 cr 
0 n. (0 U 


Ur 1 


T 


tar 
Ble 
Key w 
the S 


some 
seque 


> a a w 


ay alsc use the Pelosate command = split a Se = 
"us Co Tors setarcata blocks, Sut you dust 8SPzZ.. l5 
sd , ces for each gf the enc-pArsdust Siscks, and 

cess for the blocks that ara rct being moved as if thosa 
s were variables cr data. 

| lack variables or data blocks, then use a singls 

ers dummy value for all three cf the second cr 8822 sat 
M values, i.a., make them all three the same. 

elccatcr leaves unchanged any ROM calls cr any lsacs to 
zm the systems variables area (SCOC-SCCC;. 


YOu have relocated a program, 


ck of NAMES that pertain ta ic. 
The CHRS command 
chest it rsaddresses every 


ili do this For you. 
TRS command, excer 


block moves tc keep all 
nce. Labels will be 


Just enter the proper di 
readdressing only part cf a label File, 
the addresses 
lost (from the screen, 


ycu may want ic 
The commana c 
works ! 


If 


hav 


splacemert. 
you may 


Fils) if you destroy the ordering of the addresses. 
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he entry inta the ROM’s Floating-point creraticons, 
ded in the bytas between an RST 28 and tre 
Follcuing 38H. There is a good explanation sf this secon 
languages (Or is it third?) of the ZX in Or Logan’s artic 
SYNC 2,2. (But beware cf the two sign tests, which ar 
Jumps, as labelled in SYNC.) Notes also that thers hav 
Few changes for the 2068 ROM. 


HOT Z will read this floating-point language 
ycu turn on the flsating-soint interpreter 
IF you leave the flcating-rcint interctreter 
will get a true reading cf the ROM, but problems za 
elsewhere in memory when you ancountsr an EF that funr 
Gata rather than an RST 28. You may get lzcked irt 

Floating-point intersreter mode, without a 38H, the END 
character, in sight. The way out From this barrage of 


P 


gibBberish is the CSS-O command again, which suitzhes cut the 
Ficating-pcint interpreter entirely. Other times you may sant 
c reac it, Because this extra language is really cre oF the 


treats of the Sinclair-calculato- heritage. 


The f-c interpreter is also turned off by entry of a numerical 
address, but mot by a page Flip or a NAME, so use the last tua 
when you’re working with f-p. In addition, there is a special 
xey command, CSS-I im READ mode, which switches the flag that 
tells the disassambler which language it’s in. 


The CSS-I command (RENAU) has a dual purpcse. IF will get you 
out cf Flaating-point mods Cwithout ag See off the 
interpreter) if you need to and can’ or it will get you in 
when you want ta bs but arsn't. Yeu “may set stuck in that 
mode through addressing yourself ints the middls cf a 280 
instcucticn, For example. Since Floating-point creraticns 
imclude jumps and locps, there are alsc inclusions cf F-2 222 
that do net begin with an RST 28, branches cf ‘jumps. The 


CSS-I command will get you into these branches. Hcwever, the 
command is just a bit switch and it doesn’t Functicn wher the 
screen page itself switches from cne language at the top ta 
the sther at the bottom. The cure, when the CSS-i command 
doesn't Function is the trick of hitting the THEN key twice. 
This picks up the language mods from the bottom of the rage 
she top and reverses the reading of any bytes From one 
language ta the other. 


CF 
) 


You will also encounter scme cueesr Eshavicr if ther 5 
zode at the bottom cf the screen Te you try to write 30 ta 
the One-Sten. This is net generally fatal ard can be cured zy 
going tack to disassembly and setting the screem so that it 
ends in 280 disassembly. IF you want ta writs f-p cade, the 
smiy mamageabis way is to go into EDIT mods in data. 


natever is 


Vui 


3s 


CThat’s S ta 155 Dates. 


constants. 


to a dozen 


From six 


— 
ua 


anythi 


For Chebys 


to a value 


transcendental BASIC 


AD 


SC 


Floating-point crseraticrs are FCRTH-like stack mariculaticns 
and easy ta Fslicu if you knou something about that languages 
They use the MEM area cf the sustems variables as storage 
slots for six Fisating-scsint numbers. (Each is fiva bytes.> 
The f-p cpseraticns that transfer between the calculatcr stack 
and "EM are callac GET and STOR and ars Folicwed by a single 
digit From OQ te S ts indicate the sict used. Numbers sor 
lettsrs higher than 5 generally indicata a satsh zf nonsense 
with SET, STOR and STAK as well. 

Rang (SF tbe possible DOS Uperdtszcs d2 net <sescr in she costae 


Lm 


of the ROM, where you are likely to encounter them with HOT : 
They occur instead during the ROM’s rsading cf ZaS:7 programs; 
nd they are generally „ with a BASIC instrustisn. 


You could learn ts write Fisating-ccint S with these and 
the pursly machine-ccde 5 caer ratcrzs i7 Goo ganted c2; 32 
weuld Se similar t2 BASIC and a lite Faster. The ‘antru 


i 
point’ cf these BASIC f-p cperatscrs 
world is through the operation lasel 
Floating-Point2). However, you reed 


numbers listad as the first column of the instructicn list -z 
perform thosa BASIC functions on whatever Floating-scint 
numbers are on the calculator stack. From tha perspective cf 
a HOT 2 user, RAFP would bs used only ta Tun an cgeraticn that 
resulted from some calculation, whose result uas a coga in A. 


Two of the f-p operations deliver data directly from the code 
listing ta the calculator stack. They generally da this in an 
efficient way, using feuer than five bytes, if possible, ta 
encode the five-byts Floating-point number. HOT Z prints the 
encoded floating-point number in the NAME and mnemonics 
columns cf the disassembly listing. Since the interpreter 
dcesn’t know where any number will end, it is necessary ‘ta 
begin all cf them slightly cut sf calumn, or the longest would 
cun ints the next line and mess up the display File. The f-p 
interpreter also reads the full five hex bytes that gs cnts 
the F-p stack, rather than the condensed version that actually 
occurs in the ROM. The ADDR column keeps accurats track, and 
yOu can work cut the extra bytes, which are generally trailing 
zerces, from chat column. 


HOT 2 prints Fleating-point data by using the same ROM 
routines that handle that data, so the disassembiy Slows coun 
and becomes jerky when it has to print these Suge numbers, or 
their single-digit versions. 


FLOATING POINT OPERATIONS : 


Code Op Addr Description 


90 JRT JAAA Jusos if Ste top holds a true 

gil  SWOF 37FE Exchanges the top and second S-byte stack entry 

vz DROP 3768 Throws away top stack entry 

G5 SUB SCE  Subtracts top stack froe second stack entry 

ga MULT 3489  Mutiplies top two stack entries and leaves product on stack 
gS DIV SSéE Divides second entry by top stack, leaves quotient on stack 
ge PWR ICAC Raises 2nd on stack to power of stack top 

g7 OR S936  Perforss BASIC OR on two top stack entries and leaves result 
£8 AND SOSF  Perforas BASIC AND on two top stack entries, leaves result 
go N<=M 3956 kluger ic inequality test 

gn N»mxM 3558 Numeric inequality test 

JE  N«»M 3956  Nueric inequality test 

C N>M 3956  WNWuseric inequality test 

gD N<M 3956  Nueric inequality test 

JE Ney S956 Nuseric equality test 

gF ADD SSDI Adds two top stack entries and leaves sus on stack 

18 80ND 35948 ass a string with a nusber 

11 822 S956 String inequality test 

12 825 3756 String inequality test 

13 $«» 3956 String inequality test 

14 $> S956 String inequality test 

18 $< 395e String inequality test 

ió $a 3956 String equality test 


17 $TR+ 3787  Concatenates strings addressed by the two top stack entries 
18 VALS S9F9 BASIC Function 
19 USRS S8D7 BASIC Function 


1A RDIN SAO Read in data fros channel in A 

1B NEG 3820 Changes the sign of top stack entry 
ic CODE 3884 Replaces top stack entry with its sinclair code 
iD VAL SSFO9 BASIC function 

1E LEN SASF BASIC funetion 

15 SIN JEDE BASIC Function 

20% COS SBCS BASIC tünetión- 

21 TAN SEFI BASIC function 

z= ASN ICAE BASIC function 

z= acs DCSE BASIC function 

2 ATN SBFD BASIC function 

25 LN JEZE BASIC function 

26 EXP SADF BASIC function 

27 INT JACA BASIC function 


28 SQRT SCéS BASIC function 
29 SGNM S851 BASIC function 


zn ABS 2827 BASIC function 
zB PEEK ZS86B  BAS,C function 
2 INX 3564 BASIC function 
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$872 


SASA 
S5E4 
391C 
377F 
SABE 
3881 
3785 
3878 
3721 
3714 
SABeé 
SB9E 
SSDS 
3761 
S19D 
S828 
37DA 
S7EC 
S7CE 


BASIC function 
BASIC function 
BASIC function 
BASIC function 
Duplicates top of stack (5 bytes) 


Replaces nuaber pair by quotient on stack top, resainder below 


Unconditional relative jup 

Coseposes and stacks muaber froe following data bytes 

Loop juep as DJNI with BERG as counter 

Tests sign of stack top and replaces with true if segative 
Tests sign of stack top and replaces with true if positive 
Ends an RST 28 routine 

Adjusts angle values sodulo 2 pi for trig functions 
Rounds down to integer 

Runs byte in A as f-p op code for BASIC functions 

Deciaal exponent processor : 

Successive approxisator; stacks and processes constants 
Stacks $,1,9.5,P1/2,or 18, depending on second nibble 
Stores entry in calculator MEM slot given by 2nd nibble 
Recalls stored entry froa calculator MEM slot in 2nd nibble 
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Hot € 2068 


TS LHS ROM NAMES 


#stm 22 E Routine to change active streas 

Sand 2948 FF Executes AND between string (per sss on calc stack) and no. on calc stack 
$stk EE B Stacks paraaeters for a sliced or array-elesent string 
$tov 2F84 B Transfers a newly declared sting to variables area 
$tr-* SOR? EF Executes string concatenation for two string paraas on calc stack 
lint IFIE E Bets I-dyte integer from calc stack to A 

inum 1BES H Class 4: 6070, IF, 80 SUB, PAUSE, BORDER, OPEN, CLOSE 

inum 1BES E Evaluate one expression for cossand class 6 

ispa 128 E Opens one space at area designated by HL 

2int IF2S E sets 2-byte integer from calc stack to BC 

2num 1BDD B Class 8: POKE, BEEP, OUT 

2num 1EDD E Evaluates two expressions for Class B comeands 

Blis 14E1 B List the BASIC progras to screen 

Stop 7 B Error 9 trap for STOP comeand 

aadj FF Reduces angle size for trig calcualtions; FP op 39 
abak EF Adds back the carry when a nusber is shifted right 
abs. FF FP op to sake last calc stack value positive 

acs_ EF Replaces X on calc stack with ACS X 

adch E Adds a character to EDIT or INPUT line 

add Er Floating point addition of two nuabers 

adnx B Finds address of next program line or next variable 
alnm E Returns C flag set if A hold digit or letter 

alog 1 7 F FF Bets log base 18 of 2 to power A into A 

alph TJE H Returns C flag set if A holds a letter 

and E FF Executes AND on last two calc stack values 

arin 0 gank switches for cartridge software (BASIC) 

arin Q Searches for line no. BC in cartridge 

aros a Sets up buffer for cartridge software 

asfi F: ASCII character file (to end of ROM) 

SSW FF Replaces X on calc stack with ASN X 

atn FF Replaces X on calc stack with ATN X 

badr FF Finds base address for each fp fora in calc MEM area 
basl E Adds a new BASIC line to existing program 

bcfi E BASIC comaand routine offset table 

beep 5 Beeps in pitch and duration from calc stack (2 nos.) 
blin E Prints a BASIC line for the LIST command 

bper 5 Beeps notes according to values in DE & HL. Callable. 
brck B Bets closing bracket and loop to expression scan 

brdr RB BORDER command routine; gets color from calc stack, sets INK 
brds 2441 B Call-in point to set border with color in A (used by HZ) 
brek ZOD a Reads BREAK keys returns NC if SHIFT-BREAK is pressed 
brfl 241D E Handles BRIGHT and FLASH (C set for FLASH) 

casr 22048 B Does bank switch to EXROM for cassette routines: 

cass 24D2 EB Handles cassette cossands for cassette or disklike devices 
cat. 25C8 B Supplies CAT token in B 

cbuf MALS F Sends contents of printer buffer to printer 

ccfi 8828 F Table of offsets for control- character subroutines 
cdpm 27D6 E Subroutine to set initial parameters for CIRCLE and DRAW 


1 


celi 
chex 
chfi 
chfl 
cho2 
chop 
chr$ 
cins 
circ 
cknd 
cl1g9 
cigi 
c192 
clas 
c18984 
C185 
C185 
c 199 
c 185 
clds 
cler 
clfi 
clli 
clno 
clo2 
clos 
clos 
clow 
clpb 
clrn 
cls 
clsm 
clws 
cnfi 
cocl 
code 
coli 
co12 
col3 
col4 
colv 
comr 
cons 
cont 
copy 
cos_ 
cpfn 
cpit 
cpli 
cret 
crst 


1029 
1648 
EH 
1F 0 
iBe4 
oer 


16E8 


r 
14a) 
HH D 
Lise 
2416 


ZERA 


ei 


E Clears edit line 


Ó Channel exchange routine 

nu Channel-code offset table 

Q Set flags for channel 

o Find address of channel for given stress 

0 Channel -open routine (FD-83 as stream no. in A) 

FF Replaces X on calc stack by params of CHR$ (X) 

E Opens BC spaces at address HL 

B CIRCLE coasand routine 

E Syntax check routine; faults to error unless at line end 
E Class b; STOP, RETURN, NEW, CONT, CLS, COPY 

E Class 1: LET 

E Assigns value to variable in LET statement 

B Class 3: RUN, RAND, CLEAR, RESTORE 

B Class 4: FÜR, NEXT coasand routines 

E Class 3: DEF FN, DELETE, Od ERH, ESET, SOUND 

E Class 5: PRINT, INPUT, DIM, REM,LIST,READ,DATA,LPRINT,LLIST 
B Class 9: PLOT,DRAW,CIRCLE; sets default conditions 

B Class fg: cassette routines 

F Subroutine to clear display 

B Executes the CLEAR routine 

B Coasand class routine offset table 

F Clears lower B lines of the display 

B Compares line no. in BC with (HL), returns Z for match 
E Closes channel with channel address BC 

n Closes intelligent device 

E Executes CLOSE #N (closes channel) 

F Clears lower screen (cossand lines) 

F Clears the printer buffer 

E Entry point to CLEAR used by RUN 

F Executes BASIC CLS; callable 

B Fetches channel pointer for close-streas routine 

E Clears the editing workspace 

FE Initial channel address file 

E Changes a color system variable according to mask in B 
FF Replaces par ass of A$ on calc stack by CODE A$ 

E Sets next character to sort for color controls 

E Sorts for color itea followed by semicolon or coasa 

E Subroutine to sort for INK,PAPER,FLASH, BRIGHT, INVERSE, OVER 
B Reduces color token to control character and sends to screen 
EB Sets calor system variables for PRINT 

EB Bets comaand routine address from syntax table and jusps 
F File of constants in FP fora: 8,1,.5,pi/2,18 

E CONTINUE: loads up line and statesent no. for jusp 

F BASIC COPY command (callable) 

FF -Replaces X on calc stack with COS. X- 

B Compares found DEF FN with FN under evaluation 

E Evaluates next expression, compares with limit in HL, gives A=FF if over, else ĝ 
F Copies one pixel line to printer 

F Carriage-return routine 

E Checks for cold start syabol after RESET 


D 
aL 


csfi 

ctch 
ctem 
cusr 
darc 
data 
de+i 
deck 
defp 
dele 
delk 
dell 

dexp 
dffn 
diff 
dim 
div. 
draw 
drop 
dup. 
echp 
eddl 

eddn 
eder 
edfi 

edgr 
edit 
edky 
edlf 

edim 
edot 
edrt 
edst 
edtr 
edup 
efor 
elno 
end. 
endp 
endv 
eras 
ertr 
exp. 
fadd 
fcon 
fdev 
fet2 
fiat 
fist 
fito 
flas 
fmul 


1437 
21 ED 
aga 
SORE 


2D 1 
RIAD 
zO1D 
17425 


FF 
FF 


FF 


o 
FE 
FF 


Table of offsets for close stream routines 
Handles position control characters in PRINT: simicolon, comma, apostrophe 
Sets teaporary color values 

Checks for cartridge and if so sets up banks for USR call 
Arc-drawing subroutine 

DATA statement; syntax gets checked, but as REM in run 

Loads (DE+1) to DE, points HL to DE+2 

Decodes key value according to sode and shift state 

Handles BIN and converts decisal nos. to fp fora on calc stack 
Handles DELETE key 

Delays and waits for a keystroke (use unknown) 

Executes DELETE (lines) command 

Moves a general E-for sat deciaal to calc stack 

DEF FN command; check for syntax, skipped in RUN 

Sets KC = HL - DE; returns HL & DE exchanged 

Sets up space for new arrays in VARS, reclaims old ones if any 

FP division; exits via the eult routine 

DRAW cossand routine !26FC resuaes floating point ops) 

Executes a return to drop a number froe the calc stack 

Duplicates a nuaber on calc stack or soves a nuaber to calc stack 
Echoes keyboard buffer to current channel (lower screen) 

Handles DELETE during EDIT 

Handles cursor-down during edit 

Handles errors during EDIT 

Offset table for edit-key subroutines 

Handles graphics codes during EDIT 

Handles EDIT key functions, including INPUT 

Handles edit keys during line entry 

Handles cursor-left during EDIT 

Moves cursor toward start of edit-line 

Reads & ignores 2 characters and ends edit in error 

Handles cursor-right during EDIT 

Handles STOP key during INPUT 

Editor for BASIC line entry or INPUT 

Handles cursor-up during edit 

Converts E-format entries to floating point on calc stack 

Sets line nuaber of line in edit area to RC 

End an RST 28 calc and return to 788 language 

End of print; tests for ), carriage ret, and colon 

Adds a character to the end of VARS area and writes a new end byte (86! 
Supplies ERASE token in B 

Fetches error no. to ERR NR & resets stack 

Replaces X on calc stack by EXP X 

Prepares fp fore for addition; coaplements negatives k replaces sign bit 
Finds needed constant in table of FP constants via A 

Searches contig table for device spec in C 

Fetches 2 fp fores; first to H'F'C'CB, second to L'D'E'DE 

Finds attribute at screen coords from calc stack, stacks attribute 
Finds statement D in a BASIC line (or token E) 

Finds @atch for token in E starting at (HL) 

Prints flashing cursors 

Prepares fp fora for mult or div; tests for b, replaces sign bit 


Evaluates arguments of an FN using found DEF FN during scan 
Fetches number if there else puts zero on stack 

Evaluates FN from argument values detereined with DEF FN 
Finds new line address after a program juap 

Executes FOR cosasand with value and limit on calc stack 
Supplies FORMAT token in B 

Compresses value on calc stack into BC, C set if too big, ! 
Re-entry point for the fpop routine 

File af addresses for FP ops, Use data display 

Executes FP ops that follow RST 28. FP op interpreter 
Prints last value on calc stack to current print position 
Gets nusber from calc stack to Ay C set if overflow, Z set 
Jumps te eair routine for FREE 

Executes FREE statement 

Evaluate string expression for command class Bh 

Class 84: FORMAT, MOVE, ERASE, CAT 

Way out of cusr when cartridge is present (for USR) 
Returns attribute address (DE) for given display addr (HL) 
Gets two values from calc stack to A and EC 

Bets fp ac. from calc MEM area to calc stac (get@ to gets) 
Bets a small integer (- to #60535) froe (HL) into DE; sign 
Bets keyboard input during INPUT and EDIT 

Executes the GDSUP command 

6070: gets and tests line number for jump 

Reads out the calc stack into BCDEA 

Get current printer position parameters 

Puts PI on calc stack 

Get current print position parameters 

Evaluates expression to get value for INPUT 

Evaluates expression to get value for LET or READ 

Sets HL= HLADE; gives error 4 if overflow 

Executes IF command on last calc stack value 

Subroutine to assign an INPUT value to a variable 

Indexes into tables for various look-ups 

Puts line no. or integer in BASIC line on calc stack 

Main initialization routine when 2868 is switched on 
Executes INKEY$; stacks input string or empty string 

Saves registers and points HL to input address 

Handles INPUT LINE 

Handles control items during INFUT 

Handles siaple input variables 

Main input routine; opens channel K 

Handles STOP in an INPUT line 

Repiaces X on calc stack by INT X; Zad2 continues FP code 
Puts result of IN X onto calc stack 

Put INPUT prospt into workspace, gets input and assigns it- 
Jump relative on true on calc stack: FP op 88H 

Juap relative unconditionally: followed by offset; FP op 33 
Keyboard scan, returns @-39d in E, shift state in D 

K channel (lower screen) flag set routine 

End of keyn routine if a key pressed 

Main keyboard read and decode; key to LAST K, set 5, FLAGS 
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set if positive 


if positive 


in C req 
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CIS 
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HISE 
Lave 
4E 


cb 10 


Bip 


BE 


unda d 
lon 


Cim 
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Cursor-left routine 


Repeating key routine; sorts for tokens and DELETE 

ine 

Scans keyboard and returns keycode (Try it) 

key tables for interpretation of keyboard aodes. 

Gives display address (HL) for screen line (B) 

Use as entry to ldrw with increments in BC 

Line drawing subroutine. origin in COORDS, increments on calc stack 
f A$ on calc stack with LEN A$ 

f address in NXTLIN at end of line run 
Enters complete existing string as new string & reclaias old one 
old (bit 1 FLA6GX set) or new variables 
Looks through argusents of DEF FNs before searching VARS area 
tor line nuaber (in HL, out HL) 

nusber to HL for DELETE lines 

er in DE (from à) 

er in DE for location HL 

Executes LIST coaaand 

or tokens or aessages in file 

asand (opens printer channel) 

t stack by LN ï 

ilike DJNZ) using BREG as counter; FP op 35H 
v opening channel P first 

nt for the parser; 7 FLAGS is 1 

ne (?) 


Cursor-right rout 


Replaces paraas o 
Checks validity o 


Assigns values to 


Gives RAM address 
Bets second line 
Returns line nuab 
Returns line nuab 


Look-up routine f 
Executes LLIST co 
Replaces X on cal 
Loop on non-zero 

Executes LPRINT b 
The RUN entry poi 
A tape-nase Tout! 
Supplies the LOAD 
Looks up variable 
Froduces autosati 
Tests for top of 

Supplies MOVE tok 
Error aessage fil 
Frints error aess 
Executes A = In 1 
Hultiplies ie-bit 
FF aultiplication 
Tests calc stack 


Tests last no. on 
FF op to change s 
The BASIC NEW cos 
Sets up NITLIN fr 


Incresents CH aD 
Fetches next line 


m 


pointed to by CH ADD, NC if found, HL --> last letter in VARS 
c listing and waits for new line 

usable semory and gives report 4 if insuff. 
en in B 

e (ASCII with bit 7 of last char set) 

ages 

8 * C with carry returned in C 

integers: HL = HL & DE 

; uses integer aultiple tor seali integers 
last value, stacks | if negative, else 9 
Ferroras 12 «7? comparisons between Nos. and strings (from calc stack) 
calc stack & stacks | if positive, else @ 
ign or last value on calc stack 

sand (be careful) 

on HL and goes into statement loop 
Executes NEAT command; adds step to value & tests 
Wonaaskable interrupt routine (has a bug) 

Wav out of cusr 1f no cartridge present 

Returns when na nonmaskable interrupt address ior should) 
Executes NOT: stacks 1 if last value is 9, else stacks | 
Subroutine for ABS and NEB for small integers 

Skips floating point tora it à holds PE gar ker 

Returns NC 1f À holds a digit 

and puts character in n 

nuaber into (HL) & iHL*1) 


1488 
GEB 


gas 
12B3 
Wa Pe 


WEF 6 


iFga 
gig 
dogs 
11ED 
11E 
WEB 
1 
TBE 
2159 
ZIDH 


Checks NEXT loop limit; sets C if done 

Executes ON ERR CONTINUE 

Executes ON ERR 60 TO 

Prints out nuaber in BC up to 9999 for BASIC lines 
Prints no. pointed to by HL to 9999 for BASIC 
Prints no. in HL to four digits 

Bets channel fros calc stack and opens channel 
Open channel K (keyboard) 

Open channel P (printer) 


Open channel S (screen) 


Executes OPEN @N for channels K.S, K P 
File correlating ASCII for arithaetic ops with ROM op codes for same 


ÜPENs intellignet device 
Pushes function op code and priority onto machine stack 


Switches operator type when string op has priority over numeric 


Executes OR on two calc stack values 
Offset table for open-streas routines 


QUT: gets values from stack and executes 


Sends the character fors to screen or printer 
Handles PAPER and INK routines (C set for INK) 


Print any characters subroutine 

The sain BASIC parser; syntax-check entry point 
Passes parameters to CALL BANK routine 

Passes parameters to bus expansion unit 


Passes over DATA or DEF FN during a run 


Executes PAUSE command 

Prints characters and tokens in a BASIC line 

Part of print-a-BASIC-line loop 

Print BASIC line no. specified by HL 

Handles contro] characters with operands {INK to OVER) 

P channel iprinter) flag set routine 

Fetches character fora from file pointed to by CHARS 

Prints printable characters 

Print comma (tab) routine 

Prints various control characters: AT, TAR, color, expressions 
Prints C, E, 6, K, or L cursor 

Replaces last value on calc stack by contents of that meaory address 
Makes teap colors per ganent for color commands (Class 7) 
Subroutine to do actual PLOT; CALL with coords in BC 

PLOT command; gets coords froe calc stack and plots 

For coords on calc stack, stacks $ if color of paper, | if color of ink 
POKE: gets values from calc stack and executes 

Frintout routine normally called by RST 19 

Prints question sark for unprintable codes 

Prints character code in A 

Prints absolute value (A) as.a character code 

Print AT line & coluan in BC 

Prints a carriage return (8D, CHR$(13)) 

Priority table for arithmetic ops 

PRINT routine; opens channel S, soves pointer fros AROS 

Print a string; BC holds length, DE points to start 


ó 


prpr 7 7 F Prints characters recursively, saves registers l 

pseq 217E B Prints a sequence of characters whether to screen or printer 
ptrs 120 E Revises pointers after an insertion . 

pwr _ ICSC FF Raises last value on calc stack to power of next; continues at 3C78 as FP 
pxad 288A B Gives address of D-file byte in HL, pixel as A-7, for coordinates in BC 
qrem SARE FF Replaces X and Y on calc stack by their quotient (last val) and remainder 
quot 2971 E Handles quotes with strings and VAL$ and eabedded quotes 

rafp 271 FF Takes contents of A and runs corresponding FP op for BASIC interpreter 
rall 24a Q Does cold-start reset of all devices 

r and 1ED4 E Executes RANDOMIZE to set SEED 

rdin SAO’ FF Reads in character from channel (8-15) specified on calc stack 
read 1D97 E Executes READ con 

reci 174D E Reclaias aeaory fros DE to HL - 1 

rec2 1728 E Reclaias EC bytes fros HL onward 

rem_ 1 HR E Executes BASIC REM; ignores rest of line 

res2 Bene EF Restacks two seall integers in fp fora 

ress Bene FF Subroutine for res2, so the routine runs twice 

retn 1FD4 B Executes RETURN; gets line and statement no. from GOSUB stack 
roun SED FF An fp op to truncate a nuaber toward zero to integer fora 

rres LECA B Used by RUN to do a RESTORE 

1 S8 deuda a BASIC error trap; breaks to print aessage 

rsig gig 19 Q Sends character in A to screen or printer 

rsi8 olg a Bets next printable character at CH ADD or above to A 

rs2g] 1.25 ü Increments CH_ADD and gets next printable character 

rsz8 7 ü Juaps to floating-point calculator aode 

1 S888 a Creates BC spaces in BASIC workspace (WORKSP) 

res38 a Increments clock and scans keyboard (68 times/sec) 

rse2 Q Checks whether RESET specifies a single device 

rses 3 Bets stream data to DE and resets intelligent device 

rset E Executes ON ERR RESET 

rsew a Does ware start of all current devices 

rsrv C Üpens workspace below the calculator stack (for RST 3f) 

rsta FF FF op to send the nusber pointed to by HL to calc stack 

rstr E Executes RESTORE coasand 

run_ E Executes the RUN coasand 

runt E Records nuseric or string in FLAGS bit 6 

rusr FF Return routine for USR when cartridge is present 

stel E Gets parameters of string array element to calc stack 

s-fn E Expression scan for functions CODE (AF) to NOT (C3) 

sNot E Expression scan for NOT 

saln E Expression scan for alphanuseric character 

sano B Sets HL to point one before floating point bytes of array elesent 
sapp FF Series approsimator for calculating transcendentals (SIN, EXP, etc) 
sarr RB Bets array disension to B, separates numeric and string arrays 
satr E Expression scan for ATTR 

satt d FE sets and stores attribute byte for printed character 

sbin zn E Expression scan for decimal nuaber or for BIN 

sc$2 26071 E Entry point to read screen with coords in BC (col/line) 

sca2 , B Continues expression scan for further subexpressions 

scha 3 S channel (sain screen) flag set routine 

scl2 F Scrolling subroutine; no. lines in B 


sclo E E E Scan loop to evaluate nested functions by their priority 
scng 84 E Scans and evaluates expressions, puts result on calc stack 
scr$ zaagE B Returns character on screen at coords froe calc stack 
scr2 BRAD F Handles lower screen after a scroll 

scrl WIS ad Scrolling subroutine for 23-line scroll 

scro asp F Scrolis the display 
sdfi Dici F Initial stream data file 


sdfn SEEM B Searches for a DEF FN in progras to evaluate FN 

Sd, p } F Set display file parameters from BC (top left = 1821) 
sele E Finds parameters of an array element 

sepa E Checks for proper separator and faults to error C 

sest z Clears calc stack 

sffi E Offset table for expression scanning functions and operators 
sgnm FF SEN op; returns 1 on calc stack for +, & for 6. -1 for - 
shif FF Shifts an fp fora right to line up for addition 

sine FF Replaces X on calc stack with SIN X 

sint f Stores seall integer (- to *65235) at (HL) and next 4 bytes 
skfn B Skips over characters in DEF FN without changing CH ADD 
skip C Sorts and skips nonprintable characters for RSTi8/28 
skpt a Reads through a statement in applications cartridge 

slet B Scans for letter, looks up variable, stacks it on calc stack 
slic E Main handler for string slicing 

slug E Removes floating-point foras from BASIC lines 

smdt E Bets stream data to RC 

smin = Clears edit area, workspace, and calc stack 

sneg E Expression scan for ainus sign 

snex E Checks whether next statement or next line follows 

snum FF Moves FF fora to calc stack from elsewhere in aesory 
soun BO Executes SOUND command 

spcf B Sets flag to print copyright & curley brackets 

spnt FP talc stack pointer set: HL to last value, DE to next 
spoi E Expression scan for POINT 

sqrt EF Replaces X on calc stack with SOR X 

srnd Ei Calculates RND fros SEED 

sscr a Expression scan for SCREENS 

ssli i Looks for a slicer subscript in handling string arrays 
SSt 5 E Expression scan for STR$ and tor CHR$ 

stak EF Stacks one of the constants (£,1,.5.p1/2,18? according to znd nibble 
stbc ke Puts absolute value in BC on caic stack i-on222i 

stda EE Bets data to caic stack az new FP number 

stde E Sets DE to end of workspace iWORESP) 

stda E If A holds a digit, that digit goes onto calc stack 

stfi F Seaitone data fiie, 3 nos. per tone 

stfp EE stacks ip fora of a number supplied in code following op 34 
sthi E sets HL to start or workspace 

stig sump to the STICK routine 

stil 5 Routine for the STICK command; checks initial parameters 
sti Checks ror button pushed:unpusted 

stik E Hain routine for STICK 

SKE S E Stacks parameters for a simple string from VARS area 

St Kk 5 Sends nEDCB to calc stack 

stka E Futs absolute value in A onto calc stack (8-255) 

stkv E Finds string parameters or aodress cf array element (HL) in VARS 


c 


— 


Subroutine for evaluating statements in a line 

Supplies the SAVE token in C 

Moves FF fors from calc stack to MEM slot (stor@ to stors) 
Stores updated print position (lower screen) 

Stores updated printer buffer variables 

Stores the updated print position (upper screen) 

Replaces X on calc stack by params of STR$ J 

Return point after every statement, checks BREAK 

Setup to send tokens for disklike commands to bus expansion unit 
Subtract routine; changes a sign and proceeds to add. 

Scan te evaluate user defined functions 

Expression scan for VAL$ 

Exchanges the order of last two FP foras on calc stack 
Clears workspace and calc stack 

Escape routine for syntax checking 

Syntax test to insure numbers for arithaetic ops, strings for string ops 
Tests the syntax-checking flag 

Adds zeroes to calc stack to fill out FP fora 

Replaces I on calc stack with TAN X 

Reutine to check for channel k (lower screen) in use 

Tests for 3 bytes sore of aemory for a new FP form 

Tests key value and gets sein code from kyti 

Tests exponent for large nusbers; subroutine for roun 

BASIC token name file (ASCII w. bit 7 set for last char) 
Expands and prints BASIC tokens 

Routine to stack (calc stac) a numeric result froe scan 
Passes nu&bers from stack & strings from workspace to VARS area 
Tests for parens with two parameters enclosed, stacks thea 
File or ASCII cassette messages 

Tests for closing quotes in an expression 

Prints trailing space after token 

Tests for a i or 2 in As gives error d otherwise: for STICK 
Tests whether the 'scroil?' proapt is needed 

Tests whether scroll is necessary 

inary plus routine skips over to next character and to scan 
Unstack BC; last calc stack value to B, next last to C, signs to DE 
Executes USR X, where X is last value on calc stack 
Executes USR$ froa string parameters on calc stack 

bets last value (8-255) on calc stack to A, sign to C 

Futs a zero on calc stack for commands like RUN 

Handles both VAL and VAL$, returns no. on calc stack 

Tests FF fora pointed to by HL for #, returns C set if so 


EANO 
BAST 
BMAF 
BSST 
CALN 
CEAN 
CHUN 
ENAB 
FUNC 
GEAN 
GOEX 

GWOR 
MOVE 
FWOR 
RBSR 
REST 
RSR 
AFER 
XINT 
XNMI 


FUNC 
CALN 
XINT 
XNHI 
GWOR 
FWOR 
WESR 
RBSR 
EAST 
CHUN 
BANO 
ENAE 
BSST 
REST 
GEAN 
CEAN 
HOVE 
BMAF 
XFER 
GOEX 
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RAM REST DEIST CODE 


Bets bank no. for addr HL into A 

Gets bank status of bank B into B, horiz select to C 

Creates bit sap for active chunks, start addr in HL 

Puts status of all banks on stack as pointed to by IX 

Executes function call after stack fix up 

CALL bank; horiz select & addr froe stack plus params in & out 
Bets chunk for addr HL from high 3 bits of H 

Enables bank B, horiz select C 

Function dispatcher for ac users; JP works, CALL crashes 

Boto bank; horiz select & addr froa stack, no return 

boes to HL in EXROM 

Bets 16-bit word at addr HL bank B into HL 

Moves DE bytes from bank to bank, direction in A 

Puts DE at address HL in bank B 

Reads bank status req described nibblewise by DE, returns data in E 
Restores bank status fros stack as pointed to by Ii 

Writes E to bank status register in D 

Main routine tor transfers from bank to bank 

Fields RST 38 interrupt while EXROM is resident 

Would handle WMI but for JR NZ bug and lack of connecting code 


i FE. oS C „unter X C. o2 


Function dispatcher for ac users; JP works, CALL crashes 
Executes function call after stack fix up 

Fields RST 38 interrupt while EXROM 1s resident 

Would handle NMI but for JR NZ bug and lack of connecting code 
Gets ló-bit word at addr HL bank B into HL 

Futs DE at address HL in bank B 

Writes E to bank status register in D 

Reads bank status reg described nibblewise by DE, returns data in E 
Bets bank status of bank B into B, horiz select to C 

Bets chunk for addr HL from high 3 bits of H 

Gets bank nc. for addr HL into À 

Enables bank B, horiz select C 

Puts status of all banks on stack as pointed to by 1 

Restores bank status trom stack as pointed to by 11 

Goto bank; horiz select & addr trom stack, no return 

CALL bank: horiz select & addr from stack plus paraes in & out 
Hoves DE bytes trom bank to bank, direction in A 

creates bit aap for active chunks, start addr in HL 

Hain routine for transfers from bank to bank 

&ces to HL in EARUM 


akey 
aro? 
asig 
bood 
boot 
bsct 
cbnk 
cent 
chir 
cidi 
cldZ 
edge 
erro 
exin 
funi 
funZ 
funf 
jbnk 
lang 
1510 
ldby 
load 
lro? 
melv 
merg 
mist 
nova 
nram 
opdz 
pass 
r ebo 
rnob 
rset 
Save 
sbas 
svby 
svid 
veri 
vtab 
Mini 
xout 
4xr3e 
MAMM 
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NAMES 


Waits for a keystroke 

Checks for applications cartridge and juaps if there 
Assigns bank nuaber to current bank 

Boots highest priority device 

Sets up xout at 58» as boot routine for BASIC ROM 

Builds current systes configuration table 

Call a routine in another bank 

Cassette op entry routine: op is in taddr; sorts for syntax 
Marks intelligent devices and initializes if initializable 
Calls intelligent device initialization routine 

Closes DFILE2 and clears video aode 

Counts and times pulse edges during LOAD and VERIFY 

Error interrupt handler 

Initialization check for cartridge 

Jusp table for RAM-res code; half wrong by one byte 

Jusp table for functions in EXROM: use data and EXROM NAMES 
juap table ror functions in ROM; use data aode and ROM NAMES 
Juap interbank 

Tests for cartridge language 

Loads a block of bytes and returns 

Subroutine to LOAD bytes from tape 

Control routine for LOAD 

Checks for presence of language cartridge and jumps to it 
MERGE a line or variable ` 
Control routine for MERGE 

Machine language start up tor cartridge 

Initializes SVs without leaving space for al variables 
Test a new bank for RAM, soves in keyboard interrupt handler 
Opens OFILE2 and sets video sode 

Passes characters via bus expansion unit 

Restores border color at end of a cassette op 

Renuabers expansion banks in order of interrupt priorities 
Perforas RESET command on bus expansion unit 

Control routine for SAVE 

Starts BASIC applications cartridge 

Subroutine to SAVE bytes to tape 

Switches video eode per value in VIDHOD 

Control routine tor VERIFY 

Table for fixing up addresses when RAN-res code is aoved high 
Initializers: enables all of hose bank excpt chunk # 
Disables. and exits EAROM 

Fields keyboard/clock interrupt when EAROM Is in 

ROH copy of RAM resident code; gets soved to o288H 
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5888 gea 0 BASIC error trap: breaks to print aessage 
rsig gie 1g 0 Sends character in A to screen or printer 
rsi8 aol Q Bets next printable character at CH ADD or above to A 
rs2g8 8 ü Increaents CH ADD and gets next printable character 
rs28 ü Juaps to floating-point calculator sode 
rsid a Creates BC spaces in BASIC workspace (WÜRKSP) 
rs38 C Incresents clock and scans keyboard (68 times/sec) 
ertr Ch Fetches error no. to ERR_NR & resets stack 
nmir ü Nonaaskable interrupt routine (has a bug) 
nonm a Returns when no nonsaskable interrupt address (or should) 
nxch (i Incresents CH ADD and puts character in A 
skip a Sorts and skips nonprintable characters for RST18/29 
tofi F BASIC token nase file (ASCII w. bit 7 set for last char) 
kyfi F Key tables for interpretation of keyboard acdes. 
kbsc a Keyboard scan, returns 8-39d in E, shift state in D 
keyn a Main keyboard read and decode; key to LAST K, set 5, FLAGS 
kend 4 End of keyn routine if a key pressed 
krep a Repeating key routine: sorts for tokens and DELETE 
tesk a Tests key value and gets main code from kyfi 
deck a Decodes key value according to aode and shift state 
bper 3 Beeps notes according to values in DE & HL. Callable. 
beep ES Beeps in pitch and duration from calc stack (2 nos.) 
stfi F Semitone data file, 5 nos. per tone 

 lsnm t A tape-nase routine (?) 
pout F Printout routine noraally called by RST 15 
ccfi F Table of offsets for control-character subroutines 
kift F Cursor-left routine 
krot F Cursor-right routine 
cret F Carriage-return routine 
pcom F Print coasa (tab) routine 
pqst F Prints question sark for unprintable codes 
pcch F Handles control characters with operands (INK to OVER) 
prat F Print AT line & coluan in BC 
pcht F Prints printable characters 
stpo Stores the updated print position (upper screen) 
stp2 E Stores updated print position (lower screen) 
stps F Stores updated printer buffer variables 
gtpo F Get current print position paraseters 
gtp2 F Bet current printer position paraaeters 
pany F Print any characters subroutine 
pchr F Fetches character fora from file pointed to by CHARS 
pall Wer Eva} F Sends the character form to screen or printer 
satt T1 F Sets. and stores attribute byte for printed character 
msgs ae a F Prints error aessages 
toks yam F Expands and prints BASIC tokens 
trsp F Prints trailing space after token 
prpr F Prints characters recursively, saves registers 
lkup F Look-up routine for tokens or messages in file 
tsco F Tests whether scroll is necessary 
tsc2 F Tests whether the 'scroll?' prompt is needed 
scro F Scrolls the display 
scr? F Handles lower screen after a scroll 
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ctem 
cls_ 
clow 
clds 
sdfp 
scrl 
scl2 
clli 
gatr 
ladr 
delk 
copy 
cbuf 
clpb 
cpli 
edtr 
adch 
edky 
edfi 
edit 
eddn 
edst 
edif 
edrt 
eddl 
edot 
edim 
edup 
edgr 
eder 
Cclws 
ksca 
echp 
sthl 
stde 
slug 
new _ 
init 
main 
msfi 
basl 
cnfi 
sdfi 
gkey 
inpa 
praa 
pra2 
chop 
cho2 
chf1 
chex 


888 
AAO 
eps 
EN 
Dyi4 
WORD 
OME 
5 7 F 
DIES 
29D 
WIET 
BAW. 
WALT 
eco 
DES 
JARE 
E/ 
F 
WES e 
WRAF 
WEAF 
VEG 
RD 
GRF E 
E/ Et 
RA 
RN 
EH f= 
HD C. 
HE 
SRFED 
goi 
VCAS 
F 
WIFE 
D 
D1D 
Di 
JE ZO 
WR at 
11598 
1188 
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mi 


mod 
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Sets teaporary color values 

Executes BASIC CLS; callable 

Clears lower screen (command lines) 

Subroutine to clear display 

Set display file parameters from BC (top left = 1821) 
Scrolling subroutine for 23-line scroll 

Scrolling subroutine; no. lines in B 

Clears lower B lines of the display 

Returns attribute address (DE) for given display addr (HL) 
Bives display address (HL) for screen line (B) 
Delays and waits for a keystroke (use unknown) 
BASIC COPY command (callable) 

Sends contents of printer buffer to printer 

Clears the printer buffer 

Copies one pixel line to printer 

Editor for BASIC line entry or INPUT 

Adds a character to EDIT or INPUT line 

Handles edit keys during line entry 

Offset table for edit-key subroutines 

Handles EDIT key functions, including INPUT 

Handles cursor-down during edit 

Handles STOP key during INPUT 

Handles cursor-left during EDIT 

Handles cursor-right during EDIT 

Handles DELETE during EDIT 

Reads & ignores 2 characters and ends edit in error 
Moves cursor toward start of edit-line 

Handles cursor-up during edit 

Handles graphics codes during EDIT 

Handles errors during EDIT 

Clears the editing workspace 

Scans keyboard and returns keycode (Try it) 

Echoes keyboard buffer to current channel (lower screen) 
Sets HL to start of workspace 

Sets DE to end of workspace (WORKSP) 

Reaoves floating-point foras froe BASIC lines 

The BASIC NEW cosaand (be careful) 

Main initialization routine when 2868 is switched on 
Produces automatic listing and waits for new line 
Error message file (ASCII with bit 7 of last char set) 
Adds a new BASIC line to existing progras 

Initial channel address file 

Initial streas data file 

Bets keyboard input during INPUT and EDIT 

Saves registers and points HL to input address 
Prints absolute value (Ab as a character code 
Prints character code in A 

Channel-open routine (FD-83 as stream no. in A) 
Find address of channel for given stress 

Set flags for channel 

Channel exchange routine 
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chfi 

kcha 
scha 
pcha 
ispa 
cins 
ptrs 
line 
lino 
rsrv 
smin 
swor 
sest 
celi 

indx 
fdev 
clos 
clo2 
clo3 
csfi 

clsm 
smdt 
open 
opez? 
opid 
osfi 

opek 
opeS 
opeF 
Blis 
llis 
list 
blin 
numb 
flas 
pcur 

nxli 

pb12 
pbln 
pbas 
liad 
clno 
fist 
adnx 

diff 

reci 

rec2 
elno 
onoi 

onoz 
ono3 


140 
1428 
1465 
1488 
140 * 
L4Ce 
l4 D2 
L4ne 
l4E1 
12541 
i242 
daal 
18 
18 
lozb 
le3E 
1874 
Lore 
legi 
lobo 
loESg 
Lor 
17 ag 
J FAR 
174 
171 
lead 
1788 
1795 


i79D 
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Channel-code offset table 

K channel (lower screen) flag set routine 

S channel (sain screen) flag set routine 

P channel (printer) flag set routine 

Üpens one space at area designated by HL 

Opens BC spaces at address HL 

Revises pointers after an insertion 

Returns line nusber in DE (from 8$) 

Returns line nuaber in DE for location HL 

Opens workspace below the calculator stack (for RST 38) 
Clears edit area, workspace, and calc stack 
Clears workspace and calc stack 

Clears calc stack 

Clears edit line 

Indexes into tables for various look-ups 
Searches config table for device spec in C 
Executes CLOSE #N (closes channel) 

Closes channel with channei address BC 

Closes intelligent device 

Table of offsets for close streas routines 
Fetches channel pointer for close-stream routine 
Bets streas data to BC 

Executes OPEN N for channels K.S, K F 

Bets channel from calc stack and opens channel 
OPENS intellignet device 

Offset table for open-stream routines 

Qpen channel k (keyboard) 

Open channel 5 (screen) 

Open channel P (printer) 

List the BASIC prograa to screen 

Executes LLIST command (opens printer channel) 
Executes LIST comaand 

Prints a BASIC line for the LIST comaand 

Skips floating point form if A holds &E aarker 
Prints flashing cursors 

Prints C, E, ö, k, or L cursor 

Fetches next line nusber into (HL) & (HL*1) 

Part of print-a-BsSIC-line loop 

Print BASIC line no. specified by HL 

Prints characters and tokens in a BASIC line 
Gives RAM address for line nuaber (in HL, out HL) 
Compares line no. in BC with (HL), returns Z for match 
Finds statement D in a BASIC line ior token E) 
Finds address of next program line or next variabie 
Sets BC - HL - DE; returns HL & DE exchanged 
Reclaias aesory from DE to HL - L 

Reclaias BC bytes from HL onward 

Bets line nuaber of line in edit area to BC 
Prints out nusber in BC up to 9999 for BASIC lines 
Frints no. pointed to by HL to 9999 for BASIC 
Prints no. in HL to four digits 


arin 
arin 
aros 
bcfi 
pars 
stmt 
sepa 
strt 
lrun 
fnwl 
rem. 
lend 
nexl 
cknd 
snex 
clfi 
cles 
clas 
clas 
C185 
comr 
C181 
c 182 
aval 
Gva2 
C184 
znum 
Znum 
inum 
inum 
gtr 
g$st 
perc 
S189 
(1b 
fnum 
uzro 
Stop 
17 
for 
fito 
next 
nxlo 
read 
data 
pass 
rstr 
rres 
rand 
cont 
goto 


i7B&5 
17CF 
THG 
1945 
1827 
1844 
lms 
LARS 
LADE 
TREC 


| E44 
Marsan 
16004 


Bankswitches for cartridge software (BASIC) 

Searches for line no. BC in cartridge 

Sets up buffer for cartridge software 

BASIC command routine offset table 

The sain BASIC parser; syntax-check entry point 
Subroutine for evaluating statements in a line 

Checks for proper separator and faults to error C 
Return point after every statement, checks BREAK 

The RUN entry point for the parser; 7 FLAGS is Z 

Finds new line address after a program juap 

Executes BASIC REM; ignores rest of line 

Checks validity of address in NXTLIN at end of line run 
Sets up NXTLIN from HL and goes into statesent loop 
Syntax check routine; faults to error unless at line end 
Checks whether next statement or next line follows 
Comaand class routine offset table 

Ciass 3: RUN, RAND, CLEAR, RESTORE 

Class #; STOP, RETURN, NEW, CONT, CLS, COFY 

Class 3: DEF FN,DELETE,ON EHR, RESET, SOUND 

Class 5: PRINT, INPUT, DIM, REM, LIST, READ, DATA, LPRINT,LLIST 
Bets coasand routine address from syntax table and jumps 
Class 1: LET 

Assigns value to variable in LET statesent 

Evaluates expression to get value for LET or RERD 
Evaluates expression to get value for INPUT 

Class 4: FÜR, NEXT cossand routines 

Class B: FOKE, BEEP, QUT 

Evaluates two expressions for Class B compands 

Class o: GOTO, IF, o0SUB, PAUSE, BORDER, OPEN, CLOSE 

Evaluate one expression for comand class 6 

Class $5: FORMAT, MOVE, ERASE. CAT 

Evaluate string expression for command class 56 

Makes teap colors permanent for color commands [Class 7) 
Class 9: FLOT. DRAW. CIRCLE; sets default conditions 
Class 8B: cassette routines 

Fetches number 1f there else puts zero on stack 

Futs a zero on calc stack for cosaands like RUN 

Error F trap ror STOF command 

Executes IF command on iast calc stack value 

Executes FOR command with value and iiait on caic stack 
Finds match for token in E starting at (HL) 

Executes NEAT command; adcs step to value & tests 
Checks NEAT loop iimit; sets C if done 

E:ecutes READ command 

DATA statement; syntax gets checked, but as REM in run 
Fasses over Dufn or DEF FM during a run 

Executes RESTORE command 

Used py RUN to do a RESTORE 

Executes RANDOMIZE to set SEED 

CONTINUE: loads up line and statement no. for jump 
SOTO; gets and tests line number tor jump 
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Ot 
poke 
get2 
lint 
2i nt. 
run. 
cler 
clrn 
gosb 
memt 
retn 
paus 
brek 
dffn 
oecn 
rset 
oeat 
dell 
lihl 
soun 
syns 
lprn 
prin 
spcf 
pseq 
prcr 
pctr 
prns 
endp 
ctch 
Sm 
i np t 
inpr 
inpl 
inps 
iprm 
inas 
inst 
tchk 
coli 
col2 
cols 
col4 
colv 
pank 
cocl 
br 1 
Dr dr 
brds 
crst 
rall 


OUT: gets values from stack and executes 

POKE: gets values from calc stack and executes 

Gets two values from calc stack to A and BC 

Bets I-byte integer from calc stack to A 

Bets 2-byte integer from calc stack to HC 

Executes the RUN command 

Executes the CLEAR routine 

Entry point to CLEAR used by RUN 

Executes the GOSUK command 

Tests for top of usable aesory and gives report 4 if insuff, 
Executes RETURN; gets line and statement no. from 60518 stack 
Executes PAUSE command 

Reads BREAK key; returns NC if SHIFT-BREAK is pressed 

DEF FN comaand; check *or syntax, skipped in RUN 

Executes ON ERR CONTINUE 

Executes ON ERR RESET 

Executes ON ERR Gü TQ 

Executes DELETE (lines) command 

Gets second line number to HL for DELETE lines 

Executes SOUND coasand 

Escape routine for syntax checking 

Executes LFRINT by opening channel F first 

PRINT routine; opens channel 8, moves pointer from AROS 

Sets flag to print copyright & curlev brackets 

Prints a sequence of characters whether to screen or printer 
Prints a carriage return (8D, CHR$(1IS)) 

Prints various control characters: AT, TAR, color, expressions 
Print a string; BC holds length, DE points to start 

End af print; tests for ), carriage ret, and colon 

Handles position control characters in FRINT: siaicolon, comma, apostrophe 
Routine to change active stream 

Main input routine; opens channel K 

Handles control itess during INFUT 

Handles INFUT LINE 

Handles siaple input variables 

Fut INPUT proapt into workspace, gets input and assigns it 
Subroutine to assign an INPUT value to a variable 

Handles STOP in an INFUT line 

Routine to check for channel K (lower screen) in use 

Bets next character to sort for color controls 

Sorts for color item followed by semicolon or comaa 
Subroutine to sort for INK,PAPER,FLASH, BRIGHT, INVERSE, OVER 
Reduces color token to control character and sends to screen 
Sets color system variables for PRINT 

Handles PAPER and INK routines iC set for INK) 

Changes a color system variable according to mask in B 
Handles BRIGHT and FLASH (C set for FLASH) 

BORDER command routine: gets color from calc stack, sets INK 
Call-in point to set border with color in A (used by HI) 
Checks for cold start symbol after RESET 

Does cold-start reset of all devices 
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rse2 
rsew 
Ses 
cass 
stup 
stok 
ltok 
casr 
skpt 
pasm 
cat. 
form 
move 
eras 
pasb 
px ad 
poic 
plot 
plo2 
usbc 
usta 
circ 
draw 
darc 
cdpm 
ldrw 
ldr2 
scng 
tquo 
tpar 
synz 
scr$ 
SC 52 
fiat 
dele 
stil 
stik 
sti2 
ts12 
free 
sffi 
fred 
stig 
upls 
quot 
brck 
srnd 
gtpi 
ink$ 
sscr 
satr 


Checks whether RESET specifies a single device 

Does wars start of all current devices 

Gets stream data to DE and resets intelligent device 

Handles cassette commands for cassette or disklike devices 
Setup to send tokens for disklike commands to bus expansion unit 
Supplies the SAVE token in C 

Supplies the LOAD token in € 

Does bank switch to EXROM for cassette routines 

Reads through a statesent in applications cartridge 

Passes parameters to bus expansion unit 

Supplies CAT token in B 

Supplies FORMAT token in B 

Supplies MOVE token in B 

Supplies ERASE token in B 

Passes parameters to CALL RANK routine 

Gives address of D-file byte in HL, pixel as A-7, for coordinates in BC 
For coords on calc stack, stacks $ if color of paper, 1 if color of ink 
PLOT command; gets coords from calc stack and plots 

Subroutine to do actual PLOT; CALL with coords in BC 

Unstack BC; last calc stack value to B, next last to C, signs to DE 
Bets last value (6-255) on calc stack to A, sign to C 

CIRCLE command routine 

DRAW coasand routine i(26FC resumes floating point ops) 
Arc-drawing subroutine 

Subroutine to set initial parameters for CIRCLE and DRAW 

Line drawing subroutine, origin in COORDS, increments on calc stack 
Use as entry to ldrw with increments in BC 

Scans and evaluates expressions, puts result on calc stack 

Tests for closing quotes in an expression 

Tests for parens with two parameters enclosed, stacks thea 
Tests the syntax-checking flag 

Returns character on screen at coords from calc stack 

Entry point to read screen with coords in BC (col/line) 

Finds attribute at screen coords from calc stack, stacks attribute 
Handles DELETE key 

Routine for the STICK comaand; checks initial parameters 

Main routine for STICK 

Checks for button pushed/unpushed 

Tests for a l or 2 in à; gives error A otherwise; for STICK 
Executes FREE stateaent 

Offset table for expression scanning functions and operators 
Juaps to sain routine for FREE 

Juap to the STICK routine 

Unary plus routine skips over to next character and to scan 
Handles quotes with strings and VAL$ and eabedded quotes 

Gets closing bracket and loop to expression scan 

Calculates RND from SEED 

Puts PI on calc stack 

Executes INKEY$; stacks input string or eapty string 

Expression scan for SCREENS 

Expression scan for ATTR 
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anco 
aac 
dnb 

RUN 
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Expression scan for POINT 

Expression scan for alphanumeric character 

Expression scan for deciaal number or for BIN 

Routine to stack (calc stac) a nuaeric result from scan 

Scans for letter, looks up variable, stacks it on calc stack 
Expression scan for sinus sign 

Expression scan for Vals 

Expression scan for functions CODE (AF) to NOT (C3) 

Expression scan tor NOT 

Expression scan for STH$ and for CHR$ 

Pushes function op code and priority onto sachine stack 

Continues expression scan for further subexpressions 

Scan loop to evaluate nested functions by their priority 

Syntax test to insure nuabers for arithaetic ops, strings for string ops 
Records numeric or string in FLAGS bit 6 

Switches operator type when string op has priority over nuseric 
File correlating ASCII for arithaetic ops with ROM op codes for sase 
Priority table for arithsetic ops 

Scan to evaluate user defined functions 

Searches for a DEF FN in program to evaluate FN 

Compares found DEF FN with FN under evaluation 

Evaluates arguments of an FN using found DEF FN during scan 
Evaluates FN from argusent values deterained with DEF FN 

Skips over characters in DEF FN without changing CH ADD 

Looks up variable pointed to by CH ADD, NC if found, HL --> last letter in VARS 
Looks through er gusents of DEF FNs before searching VARS area 
Finds string paraseters or address of array element (HL) in VARS 
Stacks paraseters for a siaple string fros VARS area 

bets array dimension to B, separates numeric and string arrays 
Looks for a slicer subscript in handling string arrays 

Finds parameters of an array eleaent 

Sets HL to point one before floating point bytes of array element 
bets paraseters of string array element to calc stack 

Main handler for string slicing 

Stacks parameters for a sliced or array-elesent string 

Sends AEDCB to caic stack 

Evaluates next expression, compares with liait in HL, gives A=FF if over, else 8 
Loads (DET!) to DE, points HL to DE+2 

Sets HL- HLADE; gives error 4 if overflow 

Assigns values to oid ibit 1 FLAGX set) or new variables 

Passes nuabers froe stack & strings from workspace to VARS area 
Enters complete existing string as new string & reclaias old one 
Transters a newly declared sting to variables area 

mdds a character to the end of VARS area and writes a new end byte (88) 
Reads out the calc stack into BCDE} 

Sets up space for new arrays in VARS, reclaias old ones if any 
Returns C flag set if & hold digit or letter 

Returns C flag set if A holds a letter 

Handles BIN and converts decisal nos. to fp fore on calc stack 
Converts E-for sat entries to floating point on calc stack 

Returns NL if A holds a digit 


m? 
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THEW 
SEO 
ZEE 
2 F 
31 
12 
3148 
1 


If A holds a digit, that digit goes onto calc stack 

Puts absolute value in A onto calc stack (8-253) 

Puts absolute value in BC on calc stack (8-655353) 

Puts line no. or integer in BASIC line on calc stack 

Moves a general E-foraat decisal to calc stack 

Gets a small integer (- to #65535) from (HL) into DE; sign in C reg 
Stores small integer (- to *65535) at (HL) and next 4 bytes 
Compresses value on calc stack into BC, C set if too big, I set if positive 
Bets log base 18 of 2 to power A into A 

Bets number froe calc stack to A; C set if overflow, Z set if positive 
Prints last value on calc stack to current print position 

Executes A = 18 4 A +C with carry returned in C 

Prepares fp fore for addition; coapleaents negatives & replaces sign bit 
Fetches 2 fp foras; first to H'B'C'CB, second to L'D'E'DE 

Shifts an fp fora right to line up for addition 

Adds back the carry when a nuaber is shifted right 

Subtract routine; changes a sign and proceeds to add 

Floating point addition of two nuabers 

Multiplies le-bit integers: HL = HL t DE 

Prepares fp fora for ault or div; tests for 9, replaces sign bit 

FF aultiplication; uses integer multiple for small integers 

FP division: exits via the ault routine 

An fp op to truncate a nusber toward zero to integer fora 

Tests exponent for large nusbers; subroutine for roun 

Restacks two saall integers in fp fora 

Subroutine for res2, so the routine runs twice 

FP op to send the nuaber pointed to by HL to calc stack 

File of constants in FP fora: $,1,.2, p1/2,18 

File of addresses for FP ops. Use data display 

Executes FP ops that follow RST 28. FP op interpreter 

Re-entry point for the fpop routine 

Executes a return to drop a nuaber from the calc stack 

Takes contents of A and runs corresponding FP op for BASIC interpreter 
Tests for 5 bytes sore of aemory for a new FP fora 

Moves FP form to caic stack from elsewhere in memory 

Duplicates a nusber on calc stack or moves a nusber to calc stack 
Stacks fp fora of a number supplied in code following op M 

Gets data to calc stack as new FP number 

Adds zeroes to calc stack to fill out FP fore 

Finds needed constant in table of FP constants via A 

Finds base address for each fp fors in calc MEM area 

Gets fp ao. from calc MEM area to calc stac (get# to gets) 

Stacks one of the constants (8,1,.5,pi/2,18) according to 2nd nibble 
Moves FP fore from calc stack to MEM slot (storü to stors) 
Exchanges the order of last two FP foras on calc stack 

Series approxiaetor for calculating transcendentals (SIN, EXP, etc) 
FP op to make last calc stack value positive 

FP op to change sign of last value on calc stack 

Subroutine for ABS and NEG for seall integers 

SGN op: returns | on calc stack for +, À for à, -1 for - 

Puts result of IN X onto calc stack 
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rre 
Sr Eves 
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Replaces last value on calc stack by contents of that sesory address 
Executes USR X, where X is last value on calc stack 

Return routine for USR when cartridge is present 

Checks for cartridge and if so sets up banks for USR call 

Way out of cusr if no cartridge present 

Way out of cusr when cartridge is present (for USR) 

Executes USR$ from string parameters on calc stack 

Tests FP tora pointed to by HL for 8, returns C set if so 

Tests last no. on calc stack k stacks 1 if positive, else # 

Executes NOT; stacks | if last value is $, else stacks | 

Tests caic stack last value, stacks | if negative, else 56 

Executes DR on two calc stack values 

Executes AND on last two calc stack values 

Executes AND between string (params on calc stack) and no. on calc stack 
Ferforas 12 * comparisons between Nos. and strings (from calc stack) 
Executes string concatenation for two string per ass on calc stack 
Calc stack pointer set: HL to last value, DE to next 

Repiaces X on calc stack bv params of CHR$ (X) 

Handles both VAL and VAL$, returns no. on calc stack 

Replaces X on „alc stack bv params of STR$ ï 

Reads in character from channel (8-15) specified cn calc stack 
Replaces paraas of AS on calc stack by CODE A$ 

Replaces params of A$ on calc stack with LEN A$ 

Loop on non-zero (like DJNZ) using BREG as counter; FF op 35H 

Juap reiative unconditionally: followed by offset; FP op 33 

Jump relative on true on calc stack; FF op 9H 

End an RST 28 calc and return to 78% language 

Replaces Y and Y on caic stack bv their quotient (last val) and remainder 
Repiaces X on calc stack by INT X; 2ad2 continues FP code 

Replaces à on calc stack by EXP X 

Replaces X on calc stack by LN X 

Reduces angle size for trig caicualtions; FF op 39 

Replaces X on calc stack with COS X 


Replaces X on calc stack with SIN X 
Replaces X on calc stack with TAN X 
Repiaces X on calc stack with ATN X 
Replaces X on calc stack with ASN X 
Replaces X on calc stack with ACS X 


Replaces X on calc stack with SGR i 

Raises last value on caic stack to power of next; continues at 3C78 as FF 
File of ASCII cassette messages 

ASCII character file ite end of ROM) 


erro 
xr 3B 
xini 
xout 
boot 
svby 
rebo 
ldby 
edae 
cent 
veri 
1510 
load 
merg 
melv 
Save 
akey 
exin 
lro? 
aro? 
lang 
mist 
sbas 
nova 
bood 
bsct 
nr am 
asig 
chir 
cidi 
rset 
rnob 
opd? 
cid? 
svid 
pass 
jbnk 
cbnk 
* 
vtab 
funf 
funzZ 
funi 


dac 
wef GD 


Wes 
ra Be 
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5 7. 44 
Orb 
ubl 
val LF 
vips fE 
wl a. 
Wate E 
„DEGA 


t ea a ae C 


Aric 


B 
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Error interrupt handler 

Fields keyboard/clock interrupt when EXROM is in 
Initializer; enables all of home bank excpt chunk 8 
Disables and exits EXROM 

Sets up xout at 6899 as boot routine for BASIC ROM 
Subroutine to SAVE bytes to tape 

Restores border cclor at end of a cassette op 

Subroutine to LOAD bytes from tape 

Counts and tiaes pulse edges during LOAD and VERIFY 
Cassette op entry routine; op is in taddr; sorts for syntax 
Control] routine for VERIFY 

Loads a block of bytes and returns 

Control routine for LOAD 

Control routine for MERGE 

MERGE a line or variable 

Control routine for SAVE 

Waits for a keystroke 

Initialization check for cartridge 

Checks for presence of language cartridge and jumps to it 
Checks for applications cartridge and juaps if there 

Tests for cartridge language 

Machine language start up for cartridge 

Starts BASIC applications cartridge 

Initializes SVs without leaving space for al variables 
Boots highest priority; device 

Builds current systea configuration table 

Test a new bank for RAM, aoves in keyboard interrupt handler 
assigns bank nuaber to current bank 

Marks intelligent devices and initializes if initializable 
Calls intelligent device initialization routine 

Perforas RESET coaaand on bus expansion unit 

Renuabers expansion banks in order of interrupt priorities 
Opens DFILE2 and sets video sode 

Closes DFILE2 and clears video aode 

Switches video sode per value in VIDMOD 

Passes characters via bus expansion unit 

juap interbank 

Call a routine in another bank 

ROM copv of RAM resident code; gets moved to b269H 

Table for fixing up addresses when RAM-res code is saved high 
jump table for functions in ROM; use data sode and ROM NAMES 
Jump table for functions in EXROM; use data and EXROM NAMES 
Juap table for RAM-res code; half wrong bv one byte 


$TIN 
ZFIN 
SFIN 
4CHR 
SEIN 
880 
AER D 
ACKN 
ACMD 
ACON 
ACSH 
ADDL 
ADEN 
ADFN 
ADJR 
ADNA 
ADVA 
ADVE 
AFEX 
AFRG 
AKIN 
ALIN 
ALKE 
ALN2 
ALNA 
ANNA 
ANYC 
AFRI 
AR16 
ARE2 
ARES 
ASCD 
ASED 
ASIM 
ASRT 
ATRC 
ATDE 
ATOH 
ATFO 
AVCA 
B4SP 
BCEX 
ECRG 
BERR 
BFCL 
BFCO 
BFEL 
EI NN 
BEAR 
RK. SF 
k D 
BLAN 


CZBO 


BEDE 


beati 10 


ERE 
DAE 
DAFF 


Hor 


rs 


MARIE SS 


Sends BC characters at (HL) to current screen position 
Searches file for a NAME at (HL) 

Searches file for a NAME at (DE) 

Sends a 4-charcter string to line print buffer 

Sends S-bvte string at (HL) to current screen position 
Codes for 8-bit arithmetic ops 

Reads from screen starting from coluan zero 
Acknowledges valid kevstrokes with beep 

Sorts asseably-edit commands 

Prints (NNNN) fores in disassembly 

Codes for lé-bit ADD 

Perforas HL = HL + A, preserves A 

Address entry point, test for NAME or hex 

Bets numeric address for a NAME 

Calculates destination address for JRs 

Prints address, three spaces, and corresponding NAME if any 
Advance current address to next instruction address 
Advances edit cursor to the left 

Single-Step value for AF’ 

Single-step value for AF 

Sets 4 bytes at (HL) into top left corner 

Prints A register line in Single Step display 

Waits for a keypress, returns with key in A and C, B= 
Third address slot for alternate NAME file parameters 
Write-in slot for alternate NAME file parameters, two addresses 
Gets ready for another NAME after rejecting one 

Sends character in C to line print buffer B times 
Prints A’register line for Single Step display 

Codes for 16-bit ADC, SBC, ADD 

Reads address at left of line in A 

Reads and address from screen and preserves BC 

Tests for ASCII hex digit (@-F), returns C set if not 
Entry to asseably edit from READ eode (STOP comaand) 
Siaulation area for single stepper, which runs ordinary steps here 
Return point for asseablv-edit commands 

Codes for LD (C), 

Codes for LD (DE),À 

Converts ASCII in A to hex 

Sets screen print position corresponding to cursor attribute byte 
Advance current disassembly address 

Backs print position 4 spaces for repeat address entry 
Single-Step value for BC’ 

Single-Step value for BC 

Prints ERROR after RST 88 and checks report nuaber 
Clears line buffer and prints disassembly screen 
Address of current position in line print buffer 

Kills contents of current line print buffer at 5082 
Subroutine for asseablv of RIT, RES, SET 

Back arrow for assesblv editor 

Backspace during assesbly line edit 

Calculates destination address for backward JRs 

Prints blank if no NAME, else one space 
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BOIX 
BORS 
BOUT 
BFT1 
BFT2 
ETOS 
CADR 
CAJP 
CASC 
CASN 
CASO 
CEDI 
CBFI 
CBFL 
CO 
CDF I 
CEOF 
CESC 
CHA2 
CHAR 
CHGD 
CHNA 
CHOO 
CHFT 
CINS 
CIR( 
CIRA 
CIKS 
CIRU 
CIT( 
CITA 
CITS 
CITU 
CK IN 
CKR ( 
CKRA 
CKRH 
CERS 
CKRU 
CKRX 
CKSS 
CKT ( 
CKT) 
CKT+ 
CKTA 
CKTI 
CKTL 
CETS 
CKTU 
CKTV 
CLEN 


E26 
Den 
COSA 
EF EC 
EF EE. 
CA4ADC 
BFFE 
ESOT) 
174 
EH 
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ff as 
DED 
Fis7 2 


BFFE 
BFE 
FOE 
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nw U 


mo 


DII 


LTD 
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Asseables indexed bit ops 

BORDER color set command (BRIGHT) 

Break out routine from LD8I 

First breakpoint address 

Second breakpoint address 

Sends line buffer to screen 

Current address for disasseably 

Subroutine for assesbly of CALLS and JPs 

Call to EXROM for 2858 cassette routines 

Prompts for cassette name and puts it into cassette header buffer 
Writes tape parameters to cassette buffer (5088) 

Disassesble bit ops (codes with CB prefix) 

File of anemonics for CB instructions 

Byte flag for disasseably of CB instructions 

Delete this one 

Cosaand juap table (Step, Read, Edit, each starting with RND key) 
Check whether END address is with 256 of cursor and if not ask for new value 
Escape from asseably when '; key is pressed 

Converts hex value to ASCII and sends it to line print buffer 
Sends character in A to line buffer; preserves registers 

Changes display between Data and Disasseably 

Sets values to change and existing label 

Selects Data/Disasseably according to flag bit 4 

Entry point to Man when a NAME already exists for that address 
Inserts space at cursor during sensonics entry 


. Checks snesonic for initial ( and returns Z or NZ 


Checks anesonic for an initial A and returns Z or NZ 

Checks anesonic for initial space and returns Z or NZ 

Sets ‘initial’ position, checks value against A and returns 
Check for ‘initial’ ( in anesonic and go to error trap if not 
Check for ‘initial’ A in anesonic and go to error trap if not 
Check for “initial’ space and go to error trap if not 

Set "initial position and coapare with A, trap if not the same 
Checks insert flag and excutes insertion 

Checks for (and returns Z or MZ 

Checks for an A and returns I or NZ 

Checks for an H and returns I or NI 

Checks for a space and returns Z or NZ 

Advances position counter, checks value against A, returns 
Checks for an X and returns with Z or NZ 

Bets top line of active screen for asseably or single step screens 
Check for ( in anesonic and go to error trap if not 

Check for ) in aneaonic and go to error trap if not 

Check for + in anesonic and go to error trap if not 

Check for & in anemonic and go to error trap if not 

Check for an I in anemonic and go to error trap if not 

Check for an L in snesonic and go to error trap if not 

Check for space in anesonic and go to error trap if not 
Compare character in anesonic with A, trap if not the same 
Check for a comma in anesonic and go to error trap if not 
Clears am invalid NAME from screen 
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CLLI 
CLMM 
CLMN 
CLOS 
CLWA 
CMPO 
CNAM 
CNBA 
COCT 
CODE 
COFP 
COLR 
COMP 
CONL 
CORN 
COUN 
CFAR 
CFEC 
CPFI 
CFFI 
CREG 
CRST 
CRUN 
CSBF 
CSUM 
CTSC 
DADR 
DAF I 
DATL 
DATF 
DBEN 
DEL 1 
DELE 
DELF 
DBLR 
DCIN 
DCKS 
DDAT 
DDLD 
DEEX 
DELE 
DENA 
DERG 
DEWD 
DHED 
DIRL 
DISS 
DIS1 
DIS2 
DISZ 
DISA 


E. 18 
CERA 
DEIF 
CSA? 
EGS7 
ESDE 
C7 SA 
EE7EB 
DDF9? 
DETA 
D?7EH 
ERDAS 
F 
DASE 
E. H 
HFH 
C2F8 
DEBRA 
EFC? 
F297 
DLE 
281 
9714 
apez 
EDT 
EHF E 
DDG 
F54E 


D7AD 
EGET 
BFCC 
ECAZ 
CAC’ 
BF DE 
DF DF 


EW 4D 


E*SFF 
OH 
bere 
OCHD 
DBSD 


DIS ty 


Fills line print buffer with 32 spaces (26H) 

ERASE coaaand handler, fills cursor to END with 86 
Clears old anemonic from display screen prior to printing current one 
Closes gap in NAME file after a aove 

Clears BASIC’s work area to remove old address entries 
Deteraines position of comma in a anesonic entry 

Bets a tape nase for cassette ops 

File of ASCII conditional particles 

Bets second octal digit of A into A 

Bet instruction length and print hexcode coluan 
Interprets f-p constant-to-stack operators 

Bets in color nusber for INK, PAPER, BORDER commands 
Prints cossa to line buffer 

Disassesbles conditional foras, 7, NZ, etc. 

Gets (C) or (NN) for asseably of INs and DUTs 

Pointer for printing register display; points to register nases 
Prints closing parens to line buffer 

Compares RC and DE, returns I for match, NC if DE id 
File of conditionals for disassesbler 

Conditional particle file for disasseabler 

Identifies first register in B-bit LDs 

Handles RUN CALL command for RSTs 

Loads all registers, runs step, saves all registers 
Buffer for cassette tape header; use data aode 
Checksus command (LEN) 

Checks for space or comma; used after conditionals 
Prints 16-bit number or address NAME for disassembly 
Disasseabler anesonics arguaent juap table 

Prints one line of data display 

Prints full screen of data display 

Puts DB bytes into aeaory and redoes screen to hide thea 
File of second character of double register bases 
Resets stack when hexedit cursor is called from hexedit 
File of double register nases 

Double register file for arithaetic ops 

Bets in deriaal address for next disasseably page 
Redoes Data display after backing up one address 

Main routine for printing data display 

Codes for LD RR,NNNN (direct double load) 

Single-Step value for DE' 

Removes a character froe screen during asseably edit 
Delete-NAME command handler (EXP) 

Single-Step value for DE 

Sends hex number in DE to line buffer for printing 
Prints disasseably screen colusn headings 

Codes for direct index register LD 

Disasseable op codes from $$ to If 

Disassesble op codes from 4% to 7F (B-bit LDs) 
Disasseable op codes from 89 to BF 

Disasseable op codes from CÓ to FF 

Main disasseabler loop 


DISF 
DISS 
DIVI 
DLHL 
DLIS 
DON? 
DPAG 
DSCO 
DSKR 
DSFA 
DSWI 
DTFI 
DUM2 
DUMF 
E2FI 
EADR 
EBAK 
ECMD 
ED1I 
EDSI 
EDAT 
EDEK 
EDCO 
EDDI 
EDES 
EDF I 
EDIT 
EDMD 
EDRT 
EERT 
ENCN 
ENDA 
ENDE 
ENNA 
ENTN 
ENTF 
ENTR 
ERAS 
EREN 
EROF 
ETRI 
ETRJ 
ETRE. 
EVAD 
EXFL 
EXFA 
FCBQ 
FDAR 
FDSF 
FENS 
F188 


DDD 1 
DHA 
D7E1 
EéZS6 
FA 
DF E 
Drw 
DEDD 
C939 
E. 2 


DESE 


CE Eir 


(E 4 


CEng 


D 
CLES 


E. EDU 


AE FE 


Sorts direct loads to IX/IY from indexed displacements 
Main disassembly loop 

Divides HL by BC for decigal conversions 

Codes for LD (HL),N 

Sends lines to 2846 printer from cursor to END (LLIST) 
Checks whether a NAME look up is coapleted 
Disasseables and lists to end of screen 

READ mode command point, waiting for entry 

Bets top address on screen, sets print paraaeters for a down scroll 
Prints double space 

Data/disasseably display switch, THEN command in READ 
Various disassesbler text sessages 

Entry point for DUMP utility 

Duaps all register values to Single Step; a users’ utility 
Disassesbler anesonics for low ED instructions 

Reads entered address from ADDR slot at top left 

Backs blink bit for cursor left, escapes if too far 
Calculates offset into juap table for EDIT commands 
Disasseables op codes ED4? to ED7F 

Disasseables op codes froe ED8# to EDEF 

Data mode edit routine 

Backs cursor during edit 

EDIT cossand point, waiting for key entry 

Sorts ED prefixed ops for disasseably 

Escapes from the aiddle of an edit entry via ENTER 
Mneaonics file for disassembly of high ED instructions 
Sets up cursor at first hexedit position 

Turns on EDIT mode, changes headings, sets cursor 

EDIT command return address 

Address on stack used by syntax error trap 

Loop for entry of characters of a NAME or address 
Current address in END 

Ends a line edit, soves down cursor, reenters loop 
Entry loop for NAME at top left 

Entry point for NAME entry 

Entry point for END, DEST, LOOK at top left 

Looks up address/NAME entries 

Deletes character behind cursor during anesonics entry 
Re-entry point after error trap 

Continues syntax error processing 

Local asseably error trap 

Local assembly error trap 

Asseatiy local error trap 

Evaluates address (ADDR) for assesbly 

Frints exchange flag value to Single Step screen 
Decodes aneaonics at EX (SP) instructions 

Holds displacement byte for indexed bit operations 
Forward arrow for assembly editor 

Right arrow during asseably line edit 

Switch address for Single Step window/no-window; starts initialization file 
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Bets a number trom 9 to 7 or reports error 


44 


FIOF 
FIAG 
@ Fia 
FILC 
FILI 
FILF 
FIMN 
FINA 
FIND 
FINI 
FINS 
FIXD 
FLAG 
FLCK 
FLMM 
FLOT 
FFAG 
FFAT 
FFCF 
FPDA 
FFFI 
FFFL 
FFJR 
FSU 
FREG 
FTOB 
FWCJ 
Fuba 
Fx 
GALF 
GBAK 
GDEC 
GDSF 
GHDG 
GLIN 
GNGO 
GÜBF 
GOMO 
GOSV 
GOTI 
GQUO 
GTOF 
GTOS 
SU 
HARI 
HEYT 
HEAD 
HED 1 
HED2 
HED3 
HELO 


Ose 
Own? 


Los nO 


EA 


Dn] 


(EDS 
61 E 
Oil 


Pam 


(le Fee} 
DAES 
EECC 
EERC 
ERaC 
CCod 


Tests ASCII for hex digit 86 to #F and converts to hex 
Find again command (ABS) to locate subsequent matches to string 


Find attribute address ror current print position; set DE to input buffer 


ASCII value of fill character for Fill cosaand 

Finds current edit line 

Fills screen after an editing operation 

Finds aatch in table for the first 3 letters of the anesonic 
NAME file search routine, expects address in DE eise enter at F2NA 
Searches NAME file for a Nan at CADR 

Entry to CRUN for some siaulation routines 

Tests first instruction for tvpe and length 

nsseables invariant anemonics, e.g.. CCF, SCF 

Prints flag values to Single Step screen 

Checks disassembly flags for RST 28 or RST $8 in progress 
Fill geaory command handler (FN) 

Begins f-p interpreter for RST 28 

Finishes a disassesbly screen to bottos 

Continues floating point disassembly 

File of floating-point constants (ASCII) 

Main floating-point data interpreter 

File of floating point aneacnics 

Sets flags indicating floating-point disassembly in progress 
Interprets f-p op relative juaps 

Toggles f-p interpreter sode (CODE) 

Adds final register to 8-bit register LDs 

Moves characters from anemonics file to line buffer 

Codes for conditional JRs entered with +N displacement 

Codes for JRs entered with +N for displacement 

File of codes of ‘fixed’ anesonics 

Sets in an alphanu@eric character, rejects others 

Handles EDIT kev to back up one step or byte 

Gets in deciaal address in READ sode 

Gets in displacesent for readdressing cosaands 

Bets in a hex digit, rejects other characters 

Selects a single line of data or disasseebly to fill screen 
6o/no-go routine for Transfer, Find, etc. 

Main run-to-breakpont routine: saves window setting, forces no window 
Continues run-to-breakpoint, gets or skips window screen 
Handles value entries on Single Step screen 

installs code into memory after EDIT entry 

Checks quotes and gets character into E 

Gets top of current working screen & renews to bot ton 

Finds top of active screen area for assesbly or single-step screen 
Gets address at line 22 for screen-up 

Hex arithaetic command; prints END + cursor addr, END - Cursor addr 
Sends hex byte in A to line buffer for printing 

Prints READ sode coluan headings 

Characters for disassesbly coluan headings 

Characters for data display coiusn headings 

Characters for single step coluan headings 

Gives beep on start up or error return 
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HIDG 
HLEX 
HLIX 
HLRG 
HOLD 
HTOA 
HUNT 
HWOR 
HZET 
HZFG 
IADA 
ID16 
ID81 
IDIX 
IDLD 
IESC 
IFCH 
ILEN 
IMAR 
INAJ 
INBY 
INCK 
INCO 
INDO 
INDX 
ININ 
INES 
INKE 
INSS 
INSY 
INYE 
IOFF 
IORG 
IRDR 
IRED 
IVAR 
IX+N 
IX IY 
IXRG 
IYRG 
JCMD 
JFHL 
JRDI 
JUST 
K. ON 
K-UF 
KADD 
KATT 
KERI 
KDWN 
KEYB 


ESIC 
EF CR 
DARE 
BF DG 


DF DE 


CODE 
EVE 
DE a 
(17 4 
CBE 
Co ls 
CDDC 
E. AN 
Brice 
DLEE 


PEDD 
BFD4 
BFDZ 
DE as 
DFCA 
EAA 
DBGZ 
Düsi 


Shifts high nibble of hex byte left 

Single-Step value for HL’; storage from step to step 
Distinguishes HL, IX, and IY in disasseably 

Single-Step value for HL 

Wait point for Single Step cosaand entry 

Converts hex to ASCII in A 

Main search routine for FIND 

Sends current disasseably address to line buffer; address coluan 
Fields the ROM error traps when HOT Z is running 

Flag byte with 5073 to control HZ modes; see notes 

Calculates addresses and aoves NAMEs for an insert 

Identifies ló-bit register pair for INC/DEC instructions 

Codes for INC/DEC (IX/Y*NN) 

Codes for INC/DEC IX/Y 

Codes for LD RR, (ADDR) (indirect double load) 

Escape from insert when instruction will not fit 

Filters non-print characters before sending to line print buffer 
Look up length for instruction byte at (HL) 

Sets cursor for single-step register value entry 

Saves various registers while calling routine to set up insert addresses 
Gets in one byte from IX tape 

Checks for insert kev (EDIT) 

Locates entry point for code entry, handles insertions 

Resets disassembly after asseabled code is entered 

Gets displacement for indexed foras, prints, closes parens 

Bets in hex code instruction to screen 

INK color change comaand handler 

Codes for LDs to and froa I and R registers 

Finds line if no insert, else jumps to insert routine, for code entry 
Gets system variable NAMEs for indexed displacement reference 
Frints indexed displacement from IY for unNAMEd slots among SVs 
Switches off insert flag when cursor is moved 

Bets I/D register for IN X, (C) or QUT (C), 

Subroutine for assembly of LDI, LDIR, LDDR, LDD and siailar instructions 
Reads 186 instruction fros hex digits on screen 

File of initial HOT Z system variables for startup 

Checks and codes for (IX+NN) foras 

Set FDD@ flag for DD or FD prefixes 

Single-Step value for IX 

Single-Step value for IY 

Sets table base for edit coamand juap table 

jumps to Ath address in jump table at (HL) 

Calculates displacement for relative jusps 

Right justifies decisal numbers 

Turns on a top-line cursor at left 

Handles cursor up cos@ands 

Address on screen next to cursor, from ARED or KRED 

Address of screen-cursor attribute, for setting blink or bright 
Sets bright cursor 

Cursor down routine 

Keyboard read; waits for a key, beeps, controls aodes 
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KHED 
KLIN 
KLOC 
KLOD 
KMVS 
KOUT 
KFOS 
KKED 
KRES 
KRGT 
KSRT 
KURS 
LD68 
LD81 
LDAD 
LDIN 
LENI 
FPS 
LFPD 
LINE 
LNAM 
LNF I 
LODN 
LOOK 
LOSI 
LTDF 
LURF 
-CF 
H- DR 
M-EX 
M-IM 
M-IN 
M—OR 
M-KL 
M-RR 
MADC 
MADD 
MALD 
MAND 
MAT? 
MATS 
MBIT 
MCAL 
MCND 
MCFD 
MCFI 
NDO 
HDR 
MDEC 
MDJN 
MF IN 


E320 
HFF 1 
Dwr} 
( 
CDCA 
851 
RFF 
DETS 
16548 
(DE 
E EF 
DD 
(7 o 
Cena 
EF / 
D DDE 
LFE & 
BFEG 
D?1F 
Evi 16 
D/ E. 
EEEC 
C7FS9 
ORE? 
BFCA 
CIFA 
88 
E444 
EWE? 
E174 
Eas 
EZZI4 
EASY 
EZCÓ 


E27D 


DE wr 


i uu 


DIEDE 
U uo in 


5 (i U 


giu U 


in 


nf 


HMM Oost 


„ L IJ. I. J PD III III I. J P J 1D I 2 


Prints data screen coluan headings 

Screen line nu@ber of line with cursor, for cursor controls 
Records cursor-line as top scren line 

Loads character in A into a cursor 

Handles cursor aoves during EDIT 

Turns out cursor 

Print position on screen for cursor 

Reads address at left of cursor line 

Restores cursor at former position after a command 

Checks for cursor right, then DELETE, then command keys 
Moves line cursor right 

Records cursor attribute byte and sets blink/bright 

2868 LOAD comaand handler 

Loads ZX tapes to addresses from cursor to END 

Codes for an address when asseabling LDs 

Handles direct loads to IX/IY 

Length of current instruction during asseably, in bytes 
Address of last floating-point disasseably line for f-p interpreter 
Lists floating point data as deciaal 

Sets screen position to BC and draws 32 character line across 
Print NAME coluan for Data display 

File of instruction lengths 

Bets in tape nase for a 2868 LOAD 

Sorts instructions for disasseably look up 

Last Single-Step instruction address; top line of disasseably 
Converts screen line nusber to display file address in HL 
Look up register pair for disasseably 

Asseables CP instructions 

Asseables DB when used with hex numbers (no quotes) 
Asseables EX instructions 

Asseables IM instructions 

Asseables IN instructions 

Asseables OR instructions 

Asseables RL instructions 

Assembles RR instructions 

Asseables ADC instructions 

Asseables ADD instructions 

Asseables LD instructions; sorts on comma position 
Asseables AND instructions 

Tests for match with search string 

FIND command handler (S6N) 

Asseables BIT instructions 

Asseables CALL instructions 

Subroutine for asseably of conditional anesonics 
Asseables CPD, CPO 

Asseables CPI, CPIR 

Codes for direct arithmetic ops (e.g., ADD A, NN) 

Handles assembly op DB when used with quoted string 
Asseable DEC instructions 

Asseables DJNZ 

Finds nusbered entry in A in table at (HL), end bits 7 set 
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MFOU CIR ED Match-found escape from HUNT; displays satching location 


MHAL E149 as Assembles HALT instruction 

MINC EZAE AS Assemble INC commands 

MIND E1 DD AS Assembles IND, INDR 

MINI E1D1 AS Asseables INI, INIR 

MJFC ESZC AS Assembles JP instructions 

MJKS EJAE as Asseables JR instructions 

ML23 E7CF AS Codes for B-bit register to register loads, LD R,R’ 
ML24 E7C1 AS Codes for direct 8-bit register loads, LD R,NN 
ML25 EY AA AS Codes for LD R,'A', where A is ASCII character 
ML26 E773 AS Codes for LD R, (RR), where RR is HL, IX/Y, DE, BC 
ML28 E766 AS Codes for LD A, (ADDR) 

ML29 E AS Codes for LD R,{IX+NN), where R is an B-bit register 
ML D2 EY Oe AS Codes for LD f, I, where X is any option 

MLDS E. AS Codes for LD RR, II, where XX is direct or indirect expression or HL 


MLDS EólC AS Codes for LD (RR),X 

MLD7 Eco AS Codes for LD (ADDR), RR 

MLDS E AS Codes for LD (II MN), II, here XX is register or number 
MLDD EIDE AS Asseables LDD, LDDR 

MLDI ELD ns fisseables LDI, LDIR 

ML IN CERE GF Remakes one line when new instruction is same size as old 
MNAD dT Assembler routine juap table 

MNAM DS Looks up NAME and prints it or address if none 

MNAR DEC? DS Takes argusent from anesonics file and jusps to handler routine 
MNEA EDD FI File of aneaonics for assembly 

MNEM Dow DS Reads anesonics from file to line buffer, traps argument byte 
MNF I — 30 7 U FI File of anesonics for main instruction sequence 

MNLO AS Mnesonics edit loop for entry 

MNFR DS Finds anesonic in file and sends it to (DE) 

MNUP N Moves part of NAME file up to reorder NAMEs 

MOTD AS asseables OTDA 

MOTI ri Asseables OTIR 

MOUT n5 Asseables OUT, QUTI, OUTD instructions 

MOVE ED Subroutine for transfers, moves code in proper direction 
MPOP Fils Asseables POP instructions 

MFUS AS Asseables PUSH instructions 

MREG as Prints aain registers and their current values 

MRES AS Asseables RES instructions 

MRET fd Asseables RET instructions 

MRLC AS Asseables RLC instructions 

MRRC AS Asseables RRC instructions 

MRST AS Asseables RST instructions 

MSEC AS Assembles SBC instructions 

MSET mo assembles SET instructions 

MSLA DID ANS Asseables SLA instructions 

MSRA ED? AS Asseables SRA instructions 

MSRL E2DE ao Asseables SRL instructions 

MSUB EAZHB EE] fssesbles SUB instructions 

MVNA LEG rri Computes addresses for aoving NAHEs 

MVNM "NP Suroutine to aove a NAME 

MXOR ASS asseables XOR instructions 
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NACH. Eero AS Checks whether a sequence of characters is a NAME 


NADD BFFC WV Next address for disassesbly 

NAME DBA DS Looks up NAME at CADR and prints if there is one 

NAMV 284 NM Main routine for soving NAMES 

NAFA D Prints NAMES in coluan 14 of disasseably 

NARO Erase/backspace handler for NAME entry 

NASW NAME file switch address; off if = NEND, on if = NTOP 
NCOL Prints disassembly eode NAME coluen 

NCUR Set NAME cursor 

NENT Bets in a NAME in data aode, jusps if disassembly NAME assignsent 
NESC Escape routine during NAME entry (when ENTER is hit) 

NE Wk. Calculates new cursor position from HL + DE and sets it 
NF OU Not-found escape from HUNT 

NORA Searches stack for BASICs return address and juaps to it 
NORA üssesbler check routien for NAME or address 

NOSI Next Single-Step instruction address 

NSGN Handles alignaent of sinus sign on negative decisals 
NTDN Moves NTOP down for a NAME to be added 

NTOF Address of low expanding edge of NAME file 

NTUF Moves NTOP up after a NAME deletion 

NUME Bets B-bit hex digit to disassembly for direct loads, etc. 
INWRV Instails new register value in register display 

OCE Exchanges 2nd and 3rd octal digits of a hex byte 

OHED Prints Single-Step screen column headings 

OK IN Mnemonic is ready: put it in 

OF LO Records cursor line from A and attribute byte froe DE 
OLIN Disassembles a single instruction and prints line 
ONES Reads EDIT cursor and runs the instruction there 

OFAR Prints open paren to line buffer 

OFES Opens space in asseably edit line for insertion 

OSAS Enables asseabier loop from Single Step (STOP) 

OSES Handles value setting for A and F registers in step aode 
OSCM Processes Single Step commands 

OSCO Enters Single Step from EDIT (STEP) and runs step at cursor 
OSDF Address of Single-Step window's display file 

OSDF Address of Single-Step display point in window 

OSEN Entry loop for NAME at line 18 in Single Step 

OSN Handles NAME entry to Single step screen 

0800 Single Step exit, returns to READ sode 

OSRS Set register values command handler (VAL) 

OSRT Single-Step return point to READ 

DOVER Label marker for top or user single step stack 

FAFS FAFER color change coamand handler 

FROT Records last floating point operation in LFPG at bottom of screen 
FCHS Looks up BASIC tokens and prints thes 

FCON Print. foras (HL). (1k), (1%) for disasseablv 

FDAD III bid Print decimal address coiumn for data display 

FDAT 15 Wey Frints DaTA for invalid ED instructions 

FDIS E. Des Frints disassesblv to screen bot tos, restores cursor 
FEOP 1 ED Frints END value on screen when EDIT cursor is on 
FERR OSs Prints ERROR for RST #8 instruction sequel 


FEXF 
FFIL 
FFLA 
FFFC 
FFFO 
FHLT 
FINS 
FL —N 
PLAD 
FNIB 
FOIN 
FOKI 
FPAG 
FFIX 
FFIY 
FRAT 
FRI$ 
FRIM 
FRLD 
FRNA 
FRSC 
FRWS 
FSCR 
FSDE 
FSDW 
FSSF 
FSTA 
FTOF 
FUDB 
FUDN 
FUDS 
FUDW 
RADD 
RANA 
RCAL 
RCMD 
RDEL 
KDHX 
RDIS 
RDIT 
RDRS 
RDUF 
REAC 
KEDO 
REGS 
REIN 
RELO 
RESC 
RESK 
RETE 
RG16 


ECIS 


DECA 
CC1io 


Prints 'EXFLReS" 

Prints from any file with bit 7 set for last character 
Frints 'FLA6S' 

Prints floating point coluan in disassesbly 

Looks up and prints floating point operator anesonics 
Prints HALT anesonic 

Bets length of instruction at insert cursor 

Prints LAST-NEXT on register display 

Prints last digit of decisal nuaber 

Sends one nibble of hex byte to line buffer for printing 
Single Step's pointer for reading register values 

Inserts code into memory at proper address 

Sets up to print screen from last cursor address 

Subroutine for PUSH/POP of IX/IY 

Subroutine for simulation of FOP/PUSH IX/IY 

Set print parameters at line and colusn in RC 

Sends character string of length BC at (HL) to line print buffer 
Holds 8 or 27H for registers or exchange registers; printed 
Prints LD 

Prints ‘A’ to line buffer 

Print-screen command for Read and Single Step 

Does a print-screen to 2848 in EDIT aode 

Part-screen command; gets address and disasseables to bottoa of screen 
Print B-bit signed decimal (-12B to 127) 

Print 16-bit signed decisal 

Prints 'SP 

Prints STACK on register display 

Reprints display from top iline 2) 

Print 8-bit unsigned deciaal (f to 255) 

Pushes down seaory contents to sake room for insert 

Prints unsigned deriaal byte and a space 

Print 16-bit unsigned decimal 

Command handler to readdress a juap table (STR$) 

Reassigns NAMEs to a diplaced area of semory (LHR$ command) 
RUN CALL command handler (INT) 

Sets return address for READ commands, looks up and juaps to command 
Identifies lo-bit register pair for coding 

Reads a hex digit from the screen at BC, returns it in A 
Prints Single Step screen 

Main routine for reading back and asseabling anemonics 
Return point for RST 28, #8 disassembly routines 

Reads mneaonic entry from screen to buffer at 3015 for syntax check 
Reactivate ADDR cursor after invalid NAME entry 

Redoes the screen after edit operations 

Looks up B-bit registers in table 

Codes for LD , and LD A,R 

Command handler for relocator (MOVE) 

Resets lower part of screen only 

Resets the address cursor at top left 
Return point for syntax error traps, flags errant character 
Looks up l&-bit registers in table 
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RG8F EF óC FI File of 8-bit register nases 


RGX8 ER42 AS Identifies 8-bit registers for coding 

RGXF ESE. AS Checks syntax and gets displacement for II foras 
RHEX EYE AS Reads a hex byte froe anesonic to E 

RIAZ DrF24 DS Reads a hex address at left of line in À 

RIAD DFJ DS Reads a hex address froe screen at top left 

ROIN DS Disasseable rotate and shift instructions 

RSFF DS Reads floating point data from code stress 

RSFA 1 Qr Moves print position 1 space right with wrap around 
RSTD Diaz DS Disasseables RST instructions 

RTBF OWED a5 Runs steps and checks whether a breakpoint has been reached 
RUNT CAB? EC RUN cosaand handler; transfers control to code at cursor 
SAVN CVF A EC Bets in tape name for a 2868 SAVE 

SBF 1 14 St Set breakpoint 1 (AT) 

SBF 2 DIS? Sc Set breakpoint 2 (OR) 

SCDE FFH CIF Sends hex number in DE direct to screen 

SCDN ED Scrolls screen down and finds an instruction to fill the line 
SCND DS Tests screen bot tos, returns NC if last line printed 
SCPF AS Bets scroll line for asseably or single step screen 
SCUF ED Moves screen up for cursor at bot tos 

SDR DT Convert to signed B-bit decisal 

SDFC OF Sets DF CC from current 8 POSN, returns S PSN in HL 
SDON Ss Entry to CRUN for some siaulation routines 

SDRG S5 Sets new value for SP (USRS) in register display 
5DWO DT Convert to l6-bit signed deciaal 

SEND RC Sets END from READ aode (TO comaand) 

SEOF ED Handles TQ command to set END 

SETF S5 Sets flags register values in register display 

SFLA 525 Gets in new setting for flags register 

SHEP $5 Displays current breakpoints (AND) 

SHLF OF | Set HL' to proper value for return to ROM 

SHWT ED Displays new screen starting at HL 

SICA ss Siaulation routine for stepping CALLS 

SIFI dT Single Step simulation juap table 

SIJF S3 Sisulation routine for stepping JFs 

SIJR SS Simulation routine for stepping ufs 

SINC SG Siaulation routine for stepping INC/DEC SP 

SINS ED Sets insert flag and checks for valid END 

SJFH SS Sisulation routine for stepping f (H/ II/) 

Sk ID DS Skips over ordinary disassesbly for RST #8, 28 ops 
SKIP 85 Handles space key to skip one step 

SERL RC Handles scroll (<>) command; scrolls until BREAK 
SKUR ED Sets cursor blink and bright if caps shift untoggled 
SOFF RC Sign off; installs current NAME file as persanent, goes to BASIC 
SORC AS Searches ane@onic string for first space or cosaa 
SORT 58 Sorts for siaulation type of step instruction 

SFAC E Prints space to line buffer 

SPA AS Determines next blank space position in a anesonic entry 
SFBI BFDE WY Storage bin for stack pointer during Single Step 
SPON DCE RC Toggles flag to enable or disable SP display (AT) 
SPPO 37 OF Sets current position in line buffer to value in C 
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SPRD 
SPUP 
SRET 
SRST 
SSOR 
SSFH 
SSPL 
SSFO 
SSPT 
SSWA 
STAK 
STAR 
STE2 
STEN 
STEP 
STTL 
STWD 
SUTR 
SUWA 
SV6B8 
SVAR 
SWAS 
SWDD 
SWFP 
SWIN 
SWNA 
SWOU 
SWF 
SWTE 
TEM1 
TEM? 
TEND 
TERM 
TIXY 
TLSC 
TOFK 
TOFN 
TRAN 
TREG 
TRNA 
TXFI 
UNDR 
USDE 
USDW 
USND 
USKS 
USST 
VENT 
VERI 
VERN 
VIDC 


Doo 
De73 
De7F 
Daw 
DoE 
D27 
DSE 
C381 
Don? 
GITE 
DICC 
CAF g 
DSA 
ERAS 
DEAD 
DAGAI 
CHF 
CH4E 
D734 
C721 
D24F 
EHIC 
CB17 
682 
DAS 
CA4S 
CiBZ 
CZeg 
COCA 
. E. 
EC AE 
Coca 
15.14 
EBED 


F34o 
RF 
E 
810 
DIDE 
BELS 
DFO 
CBT ie 
. J 
GIFF 


15122 


Reads machine stack pointer and prints it upper right 
Simulation routine for stepping PUSH/POP 

Siaulation routine for stepping RETs 

Siaulation routine for stepping RSTs 


Sorts step instruction, selects sisulation routine if needed 


Siaulation routine for stepping LD SP,HL 

Sisulation routine for stepping LD SP,NNNN 

Set screen print position from line and coluan in BC 
Siaulation routine for stepping LD SP, (NNNN) 


Code to be copied into single step work area for code simulation 


Prints current user's stack on single step screen 
Initialize and start up HOT Z 

Steps current instruction in NOSI 

Start entry by printing initial character to screen 


Sets up sisulation area and runs current instruction as a step 


Clears line buffer and sets screen position to top left 
Stops window if flag set; restores screen after window 
Sets up transfer parameters, gets DEST 

Sets up stepper work area in printer buffer 

2968 SAVE command handler 

Handles value entries at top left of screen 

Switch from hexedit to assembly edit (STOP command) 
Switches disassesbly/data displays during EDIT (THEN) 
Switch floating point interpreter; PEEK command 

Checks if there has been a window, switches it IN if so 
NAME switch (OVER comaand) to change label files 
Switch out window: single step OUT cosaand 

Sets up parameters for entry in EDIT 

Switch-to-edit command (>=) 


Description: First of 9 temporary word storage bins, sostly for relocations 


Last local word variable storage bin 

Tape-end check routine for L081! 

Exits from Single Step to READ eode 

Checks and codes for II MN) 

Sets print position for top left of screen 

Sets sain ADDR cursor at top left 

Displays beginning of NAME list (RND command) 
TRANSFER command, copies aeaory contents to DEST 


Identifies second register in LDs or register in arithmetic ops 
Copies memory and moves NAMES to DEST; MERGE command in EDIT 


Various text messages for displays and proapts 
Label indicator for Single-Step stack underflow 
Convert to unsigned 8-bit decisal 

Convert to le-bit unsigned deciaal 

Prints a line of user's stack contents 
Single-Step user's stack pointer for 55 display 
Prints selected line of user's stack 

Value entry for getting in various addresses 
VERIFY command handler 

Gets in tape name for a 2868 VERIFY 

Resets the video aode. Unused. 
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VRVA 
WASS 
WCMD 
WHAR 
WHED 
WHER 
WHR2 
WIND 
WISU 
WISW 
WNAM 
WNOW 
WOFF 
WRIT 
WRFO 
WTSU 
XREG 
ZADA 
ZAFF 
ZEND 
ZESC 
ZUFF 


DDA 
EBESİ 
GC 
E28 
CF47 
DFnz 
DFAT 
Duiors 
Da7C 
DEC 
Cra 7g 
DE Se 
CDE 
CDFD 


CCEoO 


Enters Single Step from READ (STEP) and waits 

Main asseably write loop, gets commands, cursor controls 

Sets proper return address for EDIT/assembly commands and juaps 
Detersines what register for asseably of bit ops 

Puts up WRITE heading with END 

Looks for a NAME for address in entry buffer (5024-7) 

Looks for a NAME for address at (HL) 

Moves in window, executes step, and stores window 

Clears aesory for window display, sets attributes, turns on window (ATTR) 
Toggles the window stop 

Handles new NAME assignaents entered to screen 

Selects window/no-window depending on window setup 

Turns off EDIT and returns to READ 

Begins a write to memory in EDIT aode 

Advances current write position during anemonics entry 

Window transfer set up for exchanging screen files 

Prints exchange registers and their current values 

Calculates addresses for insert and delete, moves affected NAMES 
DELETE coasand handler 

Ends ZAPF routine and restores screen display 

Escape from IAPF routine when END is too close 

Handles DELETE when END is less than the cursor address 


is 
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HOT Z ADDRESSES 


HZFG aV Flag byte with 5C73 to control HI aodes; see notes 

TEMI WY Description: First of 9 temporary word storage bins, aostly for relocations 
TEM? Ww Last local word variable storage bin 

ASIM SE Sisulation area for single stepper, which runs ordinary steps here 
CSBF EF Buffer for cassette tape header; use data aode 

OVER LE Label marker for top of user single step stack 

UNDR LE Label indicator for Single-Step stack undertiow 

FENS wv Switch address for Single Step window/no-window; starts initialization file 
KATT Wy N Address of screen-cursor attribute, for setting blink or bright 
LFPS Wi Address of last floating-point disasseably line for f-p interpreter 
BFCO WV Address of current position in line print buffer 

FILC BY ASCIT value of fill character for Fill command 

COUN 61 Pointer for printing register display; points to register nases 
PRIM BY Holds # or 27H for registers or exchange registers; printed 
CCOU Eg BY Delete this one 

FOIN &F Bra WV Single Step's pointer for reading register values 

BFT1 BEBIS [nus First breakpoint address 

BFT2 BE uv Second breakpoint address 

OSDF uv Address of Single-Step display point in window 

OSDF Wy Address of Single-Step window's display file 

LOSI BECA us? Last Single-Step instruction address; top line of disasseably 
NOSI BFCo Ws Next Single-Step instruction address 

USRS BROS WY! Single-Step user's stack pointer for 88 display 

HLEX GF Cra wy Single-Step value for HL’; storage from step to step 

DEEX BFCC uv Single-Step value tor DE’ 

RBCEX GFCE Wt Single-Step value for BC' 

AFEX BF Os Waly Singie-Step value for AF’ 

IYRG As Single-Step value for IY 

IXRG Wr Single-Step value tor li 

HLRG ors Single-Step value for HL 

DERG la! Single-Step value tor DE 

ECRG [n Single-Step value for BC 

AFRG Ws Singie-step value for AF 

SFHEI ut Storage bin for stack pointer during Single Step 

LN b Third address slot for alternate NAME file parameters 

ALNA du Write-in slot for alternate NAME file parameters, two addresses 
LENI E Length of current instruction during assembly, in bytes 

ENDA HEE ut Current address in END 

*. ADD BREE We Address on screen next to cursor, fros ARED or KRED 

KFOS BV Print position on screen for cursor 

KL IN [x Screen iine number of line with cursor, for cursor controls 
FCRO pg Holds displacement byte for indexed bit operations 

CRF. ny byte flag ror disassembiy of CB instructions 

NTOF ih address of iow expanding edge of NAME file 

NASW EPEE es ah NAME file switch address; off if = NEND, on if = NTOP 

NADD AFEC ul! Next address for disasseabiv 

CADR bi Current address for disasseably 

LDBi EC Loads là tapes to addresses trom cursor to END 

INEY — bets in one byte from Z4 tape 

BOUT Cn Break out routine trom i Dol 

TEND Lie NES Tape-end check routine for LESI 

SOF ire 2 Hain run-to-breakpont routine; saves window setting. forces no window 
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DBLE 
VIDC 
GTOS 
SCFF 
CKSS 
CASC 
Swou 
FSCR 
FDIS 
FRWS 
IIR 
LTDF 
BEAR 
FDAR 
KBRI 
ATFO 
FFAG 
NAFA 
BFKL 
SWFN 
IRED 
ABRD 
ASCD 
TLSC 
SEIN 
RESK 
AKIN 
$TIN 
CLEN 
BASF 
SDFC 
SFAC 
COMF 
OF AR 
CFAR 
FRNA 
CHAR 
TOFK 
ALEE 
NORA 
BFCL 
RDHX 
RSFA 
NESC 
SFFO 
ATOH 
SSFO 
PRAT 
FIAT 
NCUR 
ENTF 


Resets stack when hexedit cursor is called trom hexedit 
Resets the video aode. Unused. 

Fads top of active screen area for assembly or single-step screen 
Bets scroll line for asseabiy or single step screen 

Gets top line of active screen for assembly or single step screens 
Call to EXROM for 2868 cassette routines 

Switch out window; single step QUT command 

Part-screen command; gets address and disasseables to bottoms of screen 
Prints disassembly to screen bottom, restores cursor 

Does a print-screen to 2648 in EDIT mode 

Sets cursor for single-step register value entry 

Converts screen line nusber to display file address in HL 
Back arrow for asseably editor 
Forward arrow for assembly editor 

Sets bright cursor 

Sets screen print position corresponding to cursor attribute byte 
Sets up to print screen from last cursor address 
Prints NAMES in coluan 14 of disasseably 
Kilis contents of current line print buffer at 5D82 

Sets up paraaeters ror entry in EDIT 
Reads Is instruction from hex digits on screen 
Reads from screen starting from colusn zero 

Tests for ASCII hex digit (@-F), returns C set if not 

Sets print position for top left of screen 

Sends S-byte string at (HL) to current screen position 
Resets the address cursor at top left 

Sets à bytes at (HL) into top left corner 

Sends BC characters at (HL: to current screen position 
Clears an invalid NAME fro@ screen 

Backs print position 4 spaces for repeat address entry 
Sets DF CC from current 5 POSH, returns S FÜSN in HL 
Prints space to line buffer 

Prints comma to line buffer 

Prints open paren to line buffer 

Prints closing parens to iine buffer 
Prints '' to line buffer 

Sends character in A to line buffer; preserves registers 
Sets main ADDR cursor at top left 
Waits for a keypress, returns with key in A and C, B-ég 
Searches stack for BASICS return address and juaps to it 
Clears line buffer and prints disasseably screen 

Reads a hex digit from the screen at BC, returns it in A 
Moves print position | space right with wrap around 
Escape routine during NAME entry (when ENTER is hit) 

Sets current position in line buffer to value in C 
Converts ASCII in n to hex 

Set screen print position from line and coluan in BC 

Set print parameters at line and coluan in BC 

Find attribute address for current print position: set DE to input buffer 
Set NAME cursor 

Entry point for END, DEST, LOOK at top left 
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ENTN 
ENCN 
ADEN 
NARO 
RANA 
FAFS 
INES 
EXFA 
GLIN 
BTOS 
STAR 
TRAN 
TRNA 
NAMV 
MVNM 
CLOS 
MNUF 
MVNA 
GDSF 
RADD 
KELO 
8988 
LD68 
CNAM 
SSWA 
KLOD 
WTSU 
CASO 
VERI 
CASN 
LODN 
SAVN 
VERN 
HARI 
NENT 
GOMO 
STWD 
GDEC 
INSS 
VENT 
INAJ 
ZADA 
IADA 
DSER 
FIAG 
MATS 
MAT? 
HUNT 
NFOU 
MF OU 
TOFN 


CB 
CIES 


wi 


Entry point for NAME entry 

Loop for entry of characters of a NAME or address 

Address entry point, test for NAME or hex 

Erase/backspace handler for NAME entry 

Reassigns NAMES to a diplaced area of memory (CHR$ command) 

PAPER color change cossand handler 

INK color change cossand handler 

Decodes aneaonics of EX (SP) instructions 

Selects a single line of data or disasseably to fill screen 

Sends line buffer to screen 

Initialize and start up HOT Z 

TRANSFER command, copies semory contents to DEST 

Copies seaory and moves NAMES to DEST; MERGE command in EDIT 

Main routine for moving NAMES 

Suroutine to aove a NAME 

Closes gap in NAME file after a move 

Moves part of NAME file up to reorder NAMES 

Cosputes addresses for moving NAMES 

Bets in displacesent for readdressing commands 

Comeand handler to readdress a juap table (STR$) 

Command handler for relocator (MOVE) 

2868 SAVE command hand! er 

2968 LOAD command handler 

Bets a tape name tor cassette ops 

Code to be copied into single step work area for code siaulation 
Loads character in A into a cursor 

Window transter set up for exchanging screen files 

Writes tape parameters to cassette buffer (5086) 

VERIFY command handler 

Prompts for cassette name and puts it into cassette header buffer 
Gets in tape nase for a 2968 LOAD 

Bets in tape nage for a 2868 SAVE 

Bets in tape nase for a 2968 VERIFY 

Hex arithaetic command; prints END + cursor addr, END - Cursor addr 
Gets in a NAME in data eode, juaps if disasseably NAME assignment 
Continues run-to-breakpoint, gets or skips window screen 

Stops window if flag set; restores screen after window 

Bets in decimal address in READ aode 

Finds line if no insert, else juaps to insert routine, for code entry 
Value entry for getting in various addresses 

Saves various registers while calling routine to set up insert addresses 
Calculates addresses for insert and delete, moves affected NAMES 
Calculates addresses and soves NAMEs for an insert 

Gets top address on screen, sets print parameters for a down scroll 
Find again command (ABS) to locate subsequent satches to string 
FIND cosaand handler (56N) 

Tests for match with search string 

Main search routine for FIND 

Not-found escape froe HUNT 

Match-found escape from HUNT; displays aatching location 

Displays beginning of NAME list (RND comeand) 
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SHWT 
DLIS 
RUNT 
SWNA 
FRSC 
CHNA 
ANNA 
WNAM 
CHFT 
DENA 
NTUF 
NTDN 
SWDD 
SUTR 
MOVE 
FL.MM 
CLMM 
GTOP 
SINS 
FILF 

FILI 

REDO 
FFFL 
WCHD 
SWTE 
HELO 
ZAFF 
ZEND 
ZUPP 
IESC 
ZESC 
GNGO 
CKIN 
FUDN 
CEOP 
SEOF 
FEOP 
0800 
ECMD 
EDMD 
EDRT 
EDCO 
WOFF 
KMVS 
ENDE 
INCK 
KRGT 
WRIT 
GOTI 
EDAT 
EDES 


C? EC 
CF4 
CA 
CAGI 
AF 
CAGE 
CAGE 
CA 7o 
CAAT 
C 
(Eg 4 
CHWS 
CR17 
LHA 
CBE 
CRAL 
CARR4 
CEDI 
CRF% 


CCeD 
CCAS 
CCH 
CODE 
CCES 
EGF? 
CDER 
CD29 
CDSE 
82 
D 
(Deas 
CDA 
CDRS 
CORRS 
(DEE 
DC 
CDCA 


Displays new screen starting at HL 

Sends lines to 2648 printer from cursor to END (LLIST) 
RUN cossand handler; transfers control to code at cursor 
NAME switch (OVER cosaand) to change label files 
Print-screen cosaand for Read and Single Step 

Sets values to change and existing label 

Bets ready for another NAME after rejecting one 

Handles new NAME assignsents entered to screen 

Entry point to WNAM when a NAME already exists for that address 
Delete-NAME cossand handler (EXP) 

Moves NTOP up after a NAME deletion 

Moves NTOP down for a NAME to be added 

Switches disasseably/data displays during EDIT (THEN) 
Sets up transfer paraseters, gets DEST 

Subroutine for transfers, moves code in proper direction 
Fill eeaory cosaand handler (FN) 

ERASE command handler, fills cursor to END with 86 

Bets top of current working screen & renews to bot tos 
Sets insert flag and checks for valid END 

Fills screen after an editing operation 

Finds current edit line 

Redoes the screen after edit operations 

Sets flags indicating floating-point disassembly in progress 
Sets proper return address for EDiT/asseably commands and juaps 
Switch-to-edit command (>=) 

Bives beep on start up or error return 

DELETE command handler 

Ends ZAPP routine and restores screen display 

Handles DELETE when END is less than the cursor address 
Escape from insert when instruction will not fit 

Escape from ZAPP routine when END is too close 

60/no-go routine for Transfer, Find, etc. 

Checks insert flag and excutes insertion 

Pushes down aeaory contents to sake room for insert 
Check whether END address is with 256 of cursor and if not ask for new value 
Handles TO command to set END 

Prints END value on screen when EDIT cursor is on 

Single Step exit, returns to READ aode 

Calculates offset into jusp table for EDIT commands 
Turns on EDIT sode, changes headings, sets cursor 

EDIT command return address 

EDIT command point, waiting for key entry 

Turns off EDIT and returns to READ 

Handles cursor aoves during EDIT 

Ends a line edit, aoves down cursor, reenters loop 
Checks for insert key (EDIT) 

Checks for cursor right, them DELETE, then command keys 
Begins a write to seaory in EDIT aode 

Installs code into aesory after EDIT entry 

Data aode edit routine 

Escapes from the si ddle of an edit entry via ENTER 
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EDBk (E88 ED Backs cursor during edit 


POKI CESS ED Inserts code into memory at proper address 

MLIN CEASE OF Resakes one line when new instruction is saae size as old 
EBAK CEKA ED Backs blink bit for cursor left, escapes if too far 
ININ CEC4 ED Bets in hex code instruction to screen 

ADVK (TEE 1 ED Advances edit cursor to the left 

FINS E ED Tests first instruction for type and length 

DUMF CF 4 Wu Dusps all register values to Single Step; a users’ utility 
WHED CF47 ED Puts up WRITE heading with END ' 

KDWN E ED Cursor down routine 

NEWK CF as ED Calculates new cursor position from HL + DE and sets it 
K-UF CF at: ED Handles cursor up com@ands 

DCKS EFSA ED Redoes Data display after backing up one address 

SCDN CF IE ED Scrolis screen down and finds an instruction to fill the line 
SKRL CECE RC Handles scroll (<>) comsand: scrolls until BREAK 

SCUP CFEB ED Moves screen up for cursor at bottoa 

SPRD Dagi RC Reads aachine stack pointer and prints it upper right 
GUFA IUBE ED Bets address at line 22 for screen-up 

SWFF RC Switch floating point interpreter; PEEK cosaand 

KOUT ED Turns out cursor 

IOFF \ ED Switches off insert flag when cursor is aoved 

KRES Deae ED Restores cursor at former position after a command 
EDIT Dw4D ED Sets up cursor at first hexedit position 

KE. ON 981 Turns on a top-line cursor at left 

KLOC IE Records cursor-line as top scren line 

OFLO Records cursor line from A and attribute byte fro DE 

K. URS Records cursor attribute byte and sets blink / bright 
SKUR Sets cursor blink and bright if caps shift untoggled 
WIND Moves in window, executes step, and stores window 
WISU Clears sesory for window display, sets attributes, turns on window (ATTR) 
SWIN Checks if there has been a window, switches it IN if so 
STTL Clears line buffer and sets screen position to top left 
FFAG Finishes a disassesbly screen to bottoa 

SFON UICE Toggles flag to enable or disable 5P display (AT) 


FFSW Dp? 
RTEF DOED 
FFIY 5444 
SHEF 1 


Toggles f-p interpreter mode (CODE) 

Runs steps and checks whether a breakpoint has been reached 
Subroutine for sigulation of POP/PUSH [X,IY 

55 Displays current breakpoints (AND) 


- 
SBF1 D14D St. Set breakpoint 1 (AT) 
SBEBF2 DIST SC Set breakpoint 2 (QR) 
SETF Dies Ss Sets flags register values in register display 
OSRS Dies SC Set register values command handler (VAL) 
SFLA DIBF 2 Gets in new setting for flags register 
SDRG DIEC 3S Sets new value tor SP (USRS) in register displav 
NWRV Ss Installs new register value in register display 
GHDG ED gets in a hex digit, rejects other characters 
GALF ED Bets in an alphanumeric character, rejects others 
GOSV 55 Handles value entries on Single Step screen 
SVAR ED Handles value entries at top left of screen 
CRST 3D Handles RUN CALL command for RSTs 
RCAL SC RUN CALL coasand handler iINT) 
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OSAS 
WISW 
OSCO 
VRVA 
HOLD 
SK IF 
GBAK 
TERM 
OSNA 
OSCM 
RDIS 
RESC 
STAK 
USND 
ADNA 
USST 
XREG 
MREG 
AL IN 
AFRI 
EXFL 
FLAG 
ARES 
FUDS 
FEXF 
FFLA 
FSSF 
ONES 
STEF 
81E2 
WNOW 
SSOR 
SORT 
SRST 
SINC 
SSFH 
SIJF 
SICA 
BORS 
SFUF 
SRET 
SSFL 
SSFT 
SJFH 
SIJR 
SUWA 
CRUN 
SDON 
DUM2 
FINI 
DISA 


DTE 
DEC. 
Debw 
DZD4 
DZD7 


paca 
D3 CC 


EVE 
Lc EM 
Dolt 


Dian 


Dong 


Doing 


nor 
ui um 


in 


wie) 


oon . . 
U F ooo: 


input 


i grum 


n git 
D (m in gig 
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1 co 
GAT 


pe ven) 
s 


Enables asseabler loop fros Single Step (STOP) 
Toggles the window stop 

Enters Single Step froa EDIT (STEP) and runs step at cursor 
Enters Single Step from READ (STEP) and waits 

Wait point for Single Step command entry 

Handles space key to skip one step 

Handles EDIT key to back up one step or byte 
Exits from Single Step to READ aode 

Handles NAME entry to Single Step screen 

Processes Single Step commands 

Prints Single Step screen 

Resets lower part of screen only 

Prints current user's stack on single step screen 
Prints a line of user's stack contents 

Prints address, three spaces, and corresponding NAME if any 
Prints selected line of user's stack 

Prints exchange registers and their current values 
Frints sain registers and their current values 
Prints & register line in Single Step display 
Prints A’register line for Single Step display 
Frints exchange flag value to Single Step screen 
Frints flag values to Single Step screen 

Reads and address from screen and preserves RC 
Prints unsigned decimal byte and a space 

Frints 'EXFLaG65" 

Frints ‘FLAGS’ 

Prints “SP 

Reads EDIT cursor and runs the instruction there 
Sets up Sigulation area and runs current instruction as a step 
Steps current instruction in NOSI 

Selects window/no-window depending on window setup 
Sorts step instruction, selects simulation routine if needed 
Sorts for sisulation type of step instr'ction 
Simulation routine tor stepping RSTs 

Simulation routine ror stepping INC / DEL SF 
Siaulation routine for stepping LD SP,HL 
Siaulation routine for stepping ufs 

Simulation routine ror stepping CALLS 

BORDER color set comeand ‘ BRIGHT) 

Simulation routine tor stepping FulSH/ FOF 
Simulation routine for stepping RETS 

Simulation routine for stepping LD SF,.NNNN 
Simulation routine for stepping LD SP, (NNNN) 
Simulation routine for stepping JFiHL/Ik/ Ir) 
Sisulation routine ror stepping ufs 

Seis up stepper work area im printer burrer 

Loads all registers, runs step. saves all registers 
Entry to CRUN for some siaulation routines 

Entry point for DUMP utility 

Entry to CRUN for some siaulation routines 

Main disasseabler loop 
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CHGD 
FTOF 
OSRT 
CHOO 
DATF 
DATL 
DDAT 
FCH$ 
DIVI 
NSGN 
JUST 
FLAD 
SDWO 
USDW 
FSDW 
FUDW 
FSDE 
FUDE 
SDEY 
USDE 
FDAD 
LNAM 
FLCK 
FLOT 
FFFC 
RSFF 
LFFD 
FFDA 
PEOT 
COFF 
PFO 
FTOR 
FFJK 
RDRS 
BERR 
CHAZ 
SKID 
OLIN 
DFAG 
RSTD 
CONL 
NUME 
ACON 
LURF 
ADJR 
BKWD 
HLIX 
FCON 
DADR 
MNAM 
HEAD 


Dade 
DEAF 
D854 


brad 


Dion 
DASE 
888 
Drir Z 
DABS 
DARE 
DAC? 
DADE 
DHE 
DiE 


Changes display between Data and Disassesbly 
Reprints display from top (line 2) 

Single-Step return point to READ 

Selects Data/Disasseably according to flag bit 4 
Prints full screen of data display 

Frints one line of data display 

Nain routine for printing data display 

Looks up BASIC tokens and prints thea 

Divides HL by BC for decisal conversions 

Handles alignment of sinus sign on negative decimals 
Right justifies decisal nuabers 

Prints last digit of decisal nuaber 

Convert to le-bit signed deciaal 

Convert to lo-bit unsigned decinal 

Print l&-bit signed deciaal 

Print lo-bit unsigned decimal 

Print B-bit signed decimal (-128 to 127) 

Print 8-bit unsigned deciaal ($ to 255) 

Convert to signed B-bit deciaal 

Convert to unsigned B-bit decisal 

Frint decisal address coluan for data display 

Print NAME coluan for Data display 

Checks disassembly flags for RST 28 or RST 58 in progress 
Begins r-p interpreter for RST 28 

Prints floating point coluan in disasseably 

Reads floating point data from code streaa 

Lists floating point data as deciaal 

Main floating-point data interpreter 

Records last floating point operation in LFFO at hottos of screen 
Interprets f-p constant-to-stack operators 

Looks up and prints floating point operator mnemonics 
Moves characters from mneaonics file to line buffer 
Interprets f-p op relative jusps 

Return point for RST 28, 88 disasseably routines 
Prints ERROR after RST 88 and checks report number 
Converts hex value to ASCII and sends it to line print buffer 
Skips over ordinary disasseably for RST #8, 28 ops 
Disasseables a single instruction and prints line 
Disasseables and lists to end of screen 

Disasseables RST instructions 

Disassesbles conditional forms, I, NZ, etc. 

Bets 8-bit hex digit to disassesbly for direct loads, etc. 
Prints (NNNN) foras in disassembly 

Look up register pair for disassesbly 

Calculates destination address for JRs 

Calculates- destination address for backward JRs 
Distinguishes HL, IX, and IY in disasseabiy 

Prints forms (HL), (IX), (IY) for disasseably 

Prints lé-bit number or address NAME for disassembly 
Looks up NAME and prints it or address if none 
Prints READ sode coluan headings 


NCOL DAF > DS Prints disassembly eode NAME coluan 


HL AN DAFF DS Prints blank if no NAME, else one space 

NAME DEJE DS Looks up NAME at CADR and prints if there is one 

FIND DHIC DS Searches NAME file for a NAME at CADR 

2FIN LE F DS Searches file for a NAME at (HL) 

SF IN DEZ DS Searches file for a NAME at (DE) 

FINA ORC DS NAME file search routine, expects address in DE else enter at F2NA 
CFEC OBA DS Compares BC and DE, returns I for match, NC if DE larger 
SHLP DEZ (UF Set HL’ to proper value for return to ROM 

D188 LE Ds Disassesble op codes from #8 to Sf 

DISS DE DS Disasseable op codes from C to FF 

DISS DRAW! DS Nain disasseably loop 

IXIY DEBDD DS Set FDD@ flag for DD or FD prefixes 

LOOK DRE? DS Sorts instructions for disassembly look up 

DIS2 DC@D DS Disasseable op codes froe 86 to BF 

CBDI DLD DS Disassemble bit ops (codes with CB prefix) 

ROIN DCE? DS Disassesble rotate and shift instructions 

DIS1 DS Disasseable op codes from 4% to 7F (B-bit LDs) 

FREG DS Adds final register to 8-bit register LDs 

CREG DS Identifies first register in 8-bit Lis 

TREG DS Identifies second register in LDs or register in arithmetic ops 
MNAR Din Takes argument from anesonics file and jusps to handler routine 
ED1I DS Disasseables op codes ED4é to ED7F 

MNEM DE Reads anemonics from file to line buffer, traps argument byte 
EDDI DS Sorts ED prefixed ops for disasseably 

FDAT ps Prints DATA for invalid ED instructions 

FHLT DOS I. DS Prints HALT anesonic 

FRLD opns 1 Frints LD 

FERR ODE J DS Prints ERROR for RST 98 instruction sequel 

EDZI Dek DS Disasseables op codes froe EDSB to EDEF 

MNFR DUE? pS Finds aneaonic in file and sends it to (DE) 

FFIL 088 OS Prints from any file with bit 7 set for last character 

INYE 1540 A OS Prints indexed displacement from JY for unNAMEd slots asong SVs 
INSY DDA4 DS Bets system variable NAMES for indexed displacement reference 
INDX Mole DS Gets displaceaent for indexed foras, prints, closes parens 
DISF PEDI Ds Sorts direct loads to IX/Iy from indexed displacements 

LDIN DODE DS Handles direct loads to IX/IY 

OCE X ODF DS Exchanges 2nd and 3rd octal digits of a hex byte 

COCT LIF = DS Gets second octal digit of A into A 

AVUA DE DS Advance current disasseably address 

MF IN DEDA DS Finds nusbered entry in A in table at (HL), end bits 7 set 
SCND DE16 DS Tests screen bottom, returns NC if last line printed 

CL MN DE IF DS Clears old anemonic fros display screen prior to printing current one 
ADVA DEZ DS Advance current address to next instruction address 

CODE DE Sr DS det instruction length and print hexcode coluan 

ILEN DEO DS Look up length for instruction byte at (HL) 

REAC DECH DS Reactivate ADDR cursor after invalid NAME entry 

DSCO DED D DS READ sode command point, waiting for entry 

RCMD IE. F DS Sets return address for READ cossands, looks up and jusps to command 
ENTR DF vR DS Looks up address/NAME entries 

EADR DF IC DS Reads entered address from ADDR slot at top left 
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RIAD 
RIAZ 
KRED 
AREZ 
ENNA 
OSEN 
JCMD 
DON? 
DSWI 
WHER 
WHR2 
JPHL 
ADDL 
HWOR 
DEWD 
HEYT 
FNIB 
SCDE 
HTOA 
LINE 
CLLI 
ANYC 
DSPA 
FRIS$ 
IFCH 
4CHR 
OHED 
DHED 
KHED 
CL WA 
KEYB 
ACKN 
OSES 
FINS 
NDR 
H- DR 
DEEN 
MHAL 
M— IM 
ETRE 
M-EX 
MRST 
IRDR 
MCFI 
MINI 
MLDD 
MCFD 


MLDI 


MIND 
MOTI 
MOTD 


DFZ 
DF24 
DF Z3 
DF 36 
DFS& 
DFeC 
DFU? 
LFE. 
DF SVE 
DFG 
DFAS 
DFC 
DFDZ 
DFDE 
DFDF 
DFE4 
DFF i 
DFFA 
EGG 
Ewig 


Eg SE 
EG 
EVA 
ED 
Ewes 
Eé 7 
E OE 
Ev E 
EWE. 
EGLE 
ED 
EWES 
E121 
E149 
EIS 
E171 
E174 
Eln4 
E] RV 
ELCD 
E. IDS 
ELDE 
EJ D> 
ELDS 
EIDD 
EIEI 
ELES 


Reads a hex address from screen at top left 

Reads a hex address at left of line in A 

Reads address at left of cursor line 

Reads address at left of line in A 

Entry Joop for NAME at top left 

Entry loop for NAME at line 18 in Single Step 

Sets table base for edit command juap table 

Checks whether a NAME look up is completed 

Data/disasseably display switch, THEN command in READ 

Looks for a NAME for address in entry buffer (5024-7) 

Looks for a NAME for address at (HL) 

jumps to Ath address in juap table at (HL) 

Performs HL = HL + A, preserves A 

Sends current disasseably address to line buffer; address coluan 
Sends hex nuaber in DE to line buffer for printing 

Sends hex byte in A to line buffer for printing 

Sends one nibble of hex byte to line buffer for printing 

Sends hex nuaber in DE direct to screen 

Converts hex to ASCII in A 

Sets screen position to BC and draws 32 character line across 
Fills line print buffer with 32 spaces (28H) 

Sends character in C to line print buffer B tiaes 

Prints double space 

Sends character string of length BC at (HL) to line print buffer 
Filters non-print characters before sending to line print buffer 
Sends a 4-charcter string to line print buffer 

Prints Single-Step screen coluan headings 

Prints disasseably screen col unn headings 

Prints data screen coluan headings 

Clears BASIU s work area to remove old address entries 

Keyboard read; waits for a key, beeps, controls sodes 
Acknowledges valid keystrokes with beep 

Handles value setting for A and f registers in step eode 

Bets length of instruction at insert cursor 

Handles asseably op DE when used with quoted string 

Asseables DB when used with hex nuabers ino quotes) 

Puts DB bytes into aesory and redoes screen to hide thea 
Asseables HALT instruction 

Asseables IM instructions | 
Asseably local error trap 

Asseables EX instructions 

Assembles RST instructions 

Subroutine for asseably of LDI, LDIR, LDOR, LDD and sisilar instructions 
Asseables CFI, CPIR 

Asseables INI, INIR | 
asseables LDG, LDDR | 
Asseables CPD, CPDR 
Assembles LDI, LDIR 
Asseables IND, INDR 
Asseables OTIR 
Asseables OTDK 


MOUT 
M—IN 
ETRJ 
IORG 
CORN 
MBIT 
MRES 
MSET 
BIMN 
WHAR 
BOIX 
MRLC 
MRKC 
M-RL 
M—RR 
HSLA 
MSRA 
MSRL 
MRET 
ETRI 
MFOF 
MFUS 
FFIX 
MINC 
MDEC 
ID81 
ID16 
IDIX 
AR16 
ACSH 
MSUB 
MAND 
HXOR 
MADD 
MADC 
MSEC 
BAGF 
M-OR 
M—-CF 
NDO 
FWDJ 
FWCJ 
MJRS 
HDJN 
JRDI 
MJFC 
MCAL 
CAJP 
MALD 
MLDS 
DIRL 
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E 
ESEG 
EAS.E 


E44 
Ede 
Etag 
E48 
E. IAE. 
E376 
Eqa 
EAE? 
in 4F d 
Et 
Euro 
iS U 
E.. . 
EZ 


ESFE 


I D 


DEI 
AWW iH in nw 
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Te par 
nono im NN 
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fi 
3k 
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utr 
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Asseables OUT, OUTI, QUTD instructions 
Asseables IN instructions 

Local assesbly error trap 

Gets I/O register for IN X, (C) or OUT (C), 
Gets (C) or (NN) for asseably of INs and QUTs 
Asseables BIT instructions 

Asseables RES instructions 

Assembles SET instructions 

Subroutine for assembly of BIT, RES, SET 

beter sines what register for assembly of bit ops 
Asseables indexed bit ops 

Assembles RLC instructions 

Asseables RRC instructions 

Assembles RL instructions 

Asseables RR instructions 

Asseables SLA instructions 

Asseables SKA instructions 

Asseables SRL instructions 

Asseables RET instructions 

Local asseably error trap 

Asseables POP instructions 

Asseables PUSH instructions 

Subroutine for PUSH/POF of IX/IY 

Asseable INC coasands 

Asseable DEC instructions 

Codes for INC/DEC (IX/Y*NN) 

Identifies 16-bit register pair for INC/DEC instructions 
Codes for INC, DEC IX/Y 

Codes for 16-bit ADC, SBC, ADD 

Codes for ló-bit ADD 

Asseables SUB instructions 

Assesbles AND instructions 

Asseables IU instructions 

asseabies ADD instructions 

Asseables ADC instructions 

Asseables SEC instructions 

Codes for 8-bit arithmetic ops 

fsseables OR instructions 

üssesbles CP instructions 

Codes for direct arithaetic ops (e.g.. ADD A,NN) 
Codes for JRs entered with +N for displacesent 
Codes for conditional JRs entered with +N displacesent 
Asseables jf instructions 

Asseables DJNI 

Calculates displacement for relative jusps 
Asseables JP instructions 

Asseables CALL instructions 

Subroutine for assembly of CALLS and ufs 
Asseables LD instructions; sorts on comma position 
Codes for LD iIY*NN), XX where XX 15 register or nuaber 
Codes for direct index register LD 
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MLD7 
MLDS 
DLHL 
ATBC 
ATDE 
MLDS 
DDLD 
IDLD 
MLD2 
INRE 
ML29 
ML28 
ML26 
ML 25 
GQUO 
HL24 
HL Z3 
KEIN 
LDAD 
NORA 
RGXF 
RGX8 
RDEL. 
IX+N 
TIXY 
ADFN 
EVAD 
CMFO 
SFAF 
NACK 
RHEX 
HIDG 
F158 
FIS 
lFICND 
RG16 
REGS 
CKRX 
CK RH 
CER ( 
CKRA 
CKRS 
CIRA 
CIR( 
CIKS 
CIRU 
CKRU 
CKTL 
CKTI 
CKT) 
Ck. T* 


1 1 1 1 2 K. 
DENTADA 


* 2 Ab 
[SE 


K E * 
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iu f 


Codes for LD (ADDR),RR 

Codes for LD IRH), J 

Codes for LD (HL),N 

Codes for LD (BC), 

Codes for LD (DE), a 

Codes for LD RR, II, where XX is direct or indirect expression or HL 
Codes for LD RA.NNNN (direct double load) 

Codes for LD RR, (ADDR) (indirect double load) 

Codes for LD R, X, where X is any option 

Codes for Lis to and from I and R registers 

Codes for LD R, (II, where R is an 8-bit register 
Codes for LD A, (ADDR) 

Codes tor LD R,iRR), where RR is HL, II/, DE, BC 
Codes for LD R,’A*, where A is ASCII character 

Checks quotes and gets character into E 

Codes for direct 8-bit register loads, LD R,NN 

Codes for B-bit register to register loads, LD R, R' 
codes for LD A,i and LD AVR 

Codes for an address when assembling Lis 

Assembler check routien ror NAME or address 

Checks syntax and gets displacement ror Ii foras 
Identities -bit registers for coding 

Identifies là-bit register pair for coding 

Checks and codes tor |IX*NN) foras 

Checks and codes for II NN 

Bets numeric address for a NAME 

Evaluates address (ADDR) for asseably 

Deteraines position of comma in a @ne@onic entry 

beter ines next blank space position in a anemonic entry 
Checks whether a sequence of characters is a NAME 
Reads a hex byte from aneaonic to E 

Shirts high nibble of hex byte left 

Gets a number from 9 to 7 or reports error 

Tests ASCII for hex digit 88 to SF and converts to hex 
Subroutine for assembly of conditional anesonics 
Looks up l6-bit registers in table 

Looks up 8-bit registers in table 

Checks for an X and returns with Z or NZ 

Checks for an H and returns I or Ni 

Checks for i and returns i or NZ 

Checks for an A and returns I or Ni 

Checks tor a space and returns Z or NZ 

Checks anesonic for an initial A and returns Z or NZ 
Checks anemonic for initial ( and returns I or NZ 
Checks anesonic for initial space and returns Z or NZ 
Sets ‘initial’ position, checks value against & and returns: 
Advances position counter, checks value against A, returns 
Check for an L in aneaonic and go to error trap if. not 
Check for an | in aneaonic and go to error trap if not 
Check for) in anemonic and ao to error trap if not 
Check tor + in anemonic and go to error trap if not 
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CKTM 
CEKET ¢ 
CKTA 
CKTS 
CITA 
CIT< 
CITS 
CITU 
CKTU 
FIMN 
SWAS 
FIXD 
RDIT 
INCO 
INDO 
KETE 
EROF 
CESC 
ASRT 
RFO 
CINS 
CTSC 
ERAS 
ASED 
WASS 
MNLO 
STEN 
K SRT 
EREN 
OK IN 
EERT 
EEE. SF 
ACMD 
FDSF 
COLR 
FSTA 
FL-N 
SOFF 
SEND 
DELE 
OFES 
RDUF 
SORC 
FFAT 
HZET 
CSUM 
DCIN 
MNEA 
FXBA 
DEL 1 
CNEA 


Eran 
Bade 
Enn 
Engel 
EnRBF 
EACE 
EAD 
E. . E. l 


E prn 
ERAGE 
EREI 
ERE? 
EBC? 
EGDI 
EBDA 


Check for a comma in anesonic and go to error trap if not 
Check for ( in anemonic and go to error trap if not 

Check for A in mnemonic and go to error trap if not 

Check for space in anesonic and go to error trap if not 
Check for ‘initial’ A in anesonic and go to error trap if not 
Check for "initial? ( in anemonic and go to error trap if not 
Check for ‘initial’ space and go to error trap if not 

Set “initial’ position and compare with A, trap it not the same 
Coapare character in mnemonic with A, trap if not the sase 
Finds watch in table for the first 3 letters of the aneaonic 
Switch from hexedit to asseably edit (STOP comaand) 
Asseables invariant mneaonics, e.g., CCF, SCF 

Main routine for reading back and assesbling anesonics 
Locates entry point for code entry, handles insertions 
Resets disassembly after assesbled code is entered 

Return point for syntax error traps, flags errant character 
Continues syntax error processing 

Escape from asseably when '; key is pressed 

Return point tor asseably-edit commands 

Advances current write position during anesonics entry 
Inserts space at cursor during senaonics entry 

Checks for space or comma; used after conditionals 

Deletes character behind cursor during anesonics entry 

Entry to asseably edit from READ sode (STOP command) 

Main assesbly write loop, gets commands, cursor controls 
Mnesonics edit loop for entry 

Start entry by printing initial character to screen 

Moves line cursor right | 

Re-entry point after error trap 

Mneaonic is ready; put it in 

Address on stack used by syntax error trap 

Backspace during asseably line edit 

Sorts asseably-edit comaands 

Right arrow during asseably line edit 

Bets in color nuaber for INK, PAPER, BORDER commands 

Frints STACK on register display 

Prints LAST-NEXT on register display 

Sign off; installs current NAME file as permanent, goes to BASIC 
Sets END from READ aode (TO command) 

Reaoves a character from screen during assembly edit 

Üpens space in asseably edit line for insertion 

Reads aneaonic entry from screen to buffer at 3DIS for syntax check 
Searches anesonic string for first space or cosas 

Continues floating point disassesbly 

Fields the ROM error traps when HOT Z is running 

Checksum command (LEN) 

Bets in decisal address for next disassembly page 

File of mnemonics for assembly 

File of codes of ‘fixed’ anemonics 

File of second character of double register nases 

File of ASCII conditional particles 


12 


HEDS EEC ET Characters for single step column headings 


HED2 EEAC Ef Characters for data display coluan headings 

HED 1 EE CU FI Characters for disassesbly coluan headings 

LNFI EEEC FI File of instruction lengths 

RG8F EF at FI File of 8-bit register nases 

EDFI EF aw FI Mnemonics file for disasseably of high ED instructions 
DBLF EFREE FI File of double register names 

CFFI EFCS E File of conditionals for disasseabler 

DTFI EFD2 Ed Various disasseabler text messages 

E2FI EFES FI Disasseabler aneaonics for low ED instructions 
CRF I F FI File of anesonics for CB instructions 

MNF I FI File of anesonics for sain instruction sequence 
DRLR FI Double register file for arithmetic ops 

CFFI FI Conditional particle file for disasseabler 

FPCF FI File of floating-point constants (ASCII) 

TXFI FI Various text aessages for displays and proapts 
IVAR FI File of initial HOT Z system variables for startup 
FFFI FI File of floating point anesonics 

MNAD JT Assembler routine juap table 

DAF I JT Disasseabler anemonics argument juap table 

SIFI ay Single Step siaulation jusp table 

CDFI JT Cossand jusp table iStep, Read, Edit, each starting with RND key) 
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